Characters and Strings

Text in character arrays and string arrays

Character arrays and string arrays provide storage for text data in MATLAB^®.

A character array is a sequence of characters, just as a numeric array is a sequence of numbers. A typical use is to store short pieces of text as character vectors, such as c = 'Hello World'.
A string array is a container for pieces of text. String arrays provide a set of functions for working with text as data. Starting in R2017a, you can create strings using double quotes, such as str = "Greetings friend". To convert data to string arrays, use the string function.

For more information, see Text in String and Character Arrays or watch Using String Arrays for Text Data.

Functions

Create, Concatenate, and Convert

String Arrays

`string`	String array
`strings`	Create string array with no characters
`join`	Combine strings

Character Arrays

`char`	Character array
`cellstr`	Convert to cell array of character vectors
`blanks`	Create character array of blanks
`newline`	Create newline character

Character or String Arrays

`compose`	Format data into multiple strings
`sprintf`	Format data into string or character vector
`strcat`	Concatenate strings horizontally
`append`	Combine strings

Convert Input Arguments

`convertCharsToStrings`	Convert character arrays to string arrays, leaving other arrays unaltered
`convertStringsToChars`	Convert string arrays to character arrays, leaving other arrays unaltered
`convertContainedStringsToChars`	Convert string arrays at any level of cell array or structure

Convert Between Numeric and Strings

`double`	Double-precision arrays
`string`	String array
`str2double`	Convert strings to double precision values
`num2str`	Convert numbers to character array

Determine Type and Properties

Data Type

`ischar`	Determine if input is character array
`iscellstr`	Determine if input is cell array of character vectors
`isstring`	Determine if input is string array
`isStringScalar`	Determine if input is string array with one element

Text Properties

`strlength`	Lengths of strings
`isstrprop`	Determine which characters in input strings are of specified category
`isletter`	Determine which characters are letters
`isspace`	Determine which characters are space characters

Find and Replace

Find

`contains`	Determine if pattern is in strings
`matches`	Determine if pattern matches strings
`count`	Count occurrences of pattern in strings
`endsWith`	Determine if strings end with pattern
`startsWith`	Determine if strings start with pattern
`strfind`	Find strings within other strings
`sscanf`	Read formatted data from strings

Replace

`replace`	Find and replace one or more substrings
`replaceBetween`	Replace substrings between start and end points
`strrep`	Find and replace substrings

Join and Split

`join`	Combine strings
`split`	Split strings at delimiters
`splitlines`	Split strings at newline characters
`strjoin`	Join strings in array
`strsplit`	Split string or character vector at specified delimiter
`strtok`	Selected parts of strings

Edit

`erase`	Delete substrings within strings
`eraseBetween`	Delete substrings between start and end points
`extractAfter`	Extract substrings after specified positions
`extractBefore`	Extract substrings before specified positions
`extractBetween`	Extract substrings between start and end points
`insertAfter`	Insert strings after specified substrings
`insertBefore`	Insert strings before specified substrings
`pad`	Add leading or trailing characters to strings
`strip`	Remove leading and trailing characters from strings
`lower`	Convert strings to lowercase
`upper`	Convert strings to uppercase
`reverse`	Reverse order of characters in strings
`deblank`	Remove trailing whitespace from ends of strings
`strtrim`	Remove leading and trailing whitespace from strings
`strjust`	Justify strings

Compare

`strcmp`	Compare strings
`strcmpi`	Compare strings (case insensitive)
`strncmp`	Compare first `n` characters of strings (case sensitive)
`strncmpi`	Compare first `n` characters of strings (case insensitive)

Regular Expressions

`regexp`	Match regular expression (case sensitive)
`regexpi`	Match regular expression (case insensitive)
`regexprep`	Replace text using regular expression
`regexptranslate`	Translate text into regular expression

Topics

Text in String and Character Arrays

Store and manipulate text using either string arrays or character arrays.

Update Your Code to Accept Strings

Adopt string arrays as a text data type in your own code, following these guidelines.

Analyze Text Data with String Arrays

This example shows how to analyze text data with string arrays. It shows how to store, split, and sort text, and how to compute and collect statistics for text in a string array.

Test for Empty Strings and Missing Values
Search and Replace Text
Compare Text

Formatting Text

Compose character arrays or string arrays that include ordinary text and data formatted to your specification.

Hexadecimal and Binary Values

Specify hexadecimal and binary values either as literals or as text. Hexadecimal and binary literals are stored as integers. You can convert text representing hexadecimal and binary values to numbers, and numbers to text representations.

Unicode and ASCII Values

MATLAB stores all characters as Unicode characters. Both strings and character vectors use the same encoding. You can convert characters to their Unicode code values, and numbers to characters.

Regular Expressions

Regular expressions are a versatile way to search and replace text.

Documentation