MATLAB Function Reference  char

Convert to character array (string)

Syntax

• ```S = char(X)
S = char(C)
S = char(t1, t2, t3, ...)
```

Description

```S = char(X) ``` converts the array `X` that contains positive integers representing character codes into a MATLAB character array (the first 127 codes are ASCII). The actual characters displayed depend on the character set encoding for a given font. The result for any elements of `X` outside the range from 0 to 65535 is not defined (and can vary from platform to platform). Use `double` to convert a character array into its numeric codes.

```S = char(C), ``` when `C` is a cell array of strings, places each element of `C` into the rows of the character array `s`. Use `cellstr` to convert back.

```S = char(t1, t2, t3, ...) ``` forms the character array `S` containing the text strings `T1`, `T2`, `T3`, `...` as rows, automatically padding each string with blanks to form a valid matrix. Each text parameter, `T``i`, can itself be a character array. This allows the creation of arbitrarily large character arrays. Empty strings are significant.

Remarks

Ordinarily, the elements of `A` are integers in the range 32:127, which are the printable ASCII characters, or in the range 0:255, which are all 8-bit values. For noninteger values, or values outside the range 0:255, the characters printed are determined by `fix(rem(A, 256))`.

Examples

To print a 3-by-32 display of the printable ASCII characters,

• ```ascii = char(reshape(32:127, 32, 3)')
ascii =
! " # \$ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ?
@ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _
' a b c d e f g h i j k l m n o p q r s t u v w x y z { | } ~
```

See Also

`cellstr`, `double`, `get`, `set`, `strings`, `strvcat`, `text`

© 1994-2005 The MathWorks, Inc.