strings

Create string array with no characters

collapse all in page

Syntax

str = strings
str = strings(n)
str = strings(sz1,...,szN)
str = strings(sz)

Description

str = strings returns a string with no characters. For more information on string arrays, see string.

Note: Starting in R2017a, you also can use double quotes. For example, str = "" creates a string scalar that contains no characters.

example

str = strings(n) returns an n-by-n string array. Each element is a string with no characters.

example

str = strings(sz1,...,szN) returns a sz1-by-...-by-szN string array, where sz1,...,szN indicate the size of each dimension. For example, strings(2,3) returns a 2-by-3 string array where each element is "".

example

str = strings(sz) returns a string array where size vector sz defines size(str). For example, strings([2,3]) returns a 2-by-3 string array.

Examples

collapse all

Open Live Script
str = strings(4)
str = 4x4 string
    ""    ""    ""    ""
    ""    ""    ""    ""
    ""    ""    ""    ""
    ""    ""    ""    ""
Open Live Script
str = strings([2,6])
str = 2x6 string
    ""    ""    ""    ""    ""    ""
    ""    ""    ""    ""    ""    ""
Open Live Script

Create an array of empty strings that is the same size as an existing array.

A = [1 2 3; 4 5 6];
sz = size(A);
str = strings(sz)
str = 2x3 string
    ""    ""    ""
    ""    ""    ""

It is a common pattern to combine the previous two lines of code into a single line:

str = strings(size(A));

You can use strings to preallocate the space required for a large string array.

Input Arguments

collapse all

Size of a square array, specified as a nonnegative integer.

  • If n is 0, then str is an empty array.

  • If n is negative, then strings treats n as 0.

Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Size of each dimension, specified as separate nonnegative integer arguments.

  • If the size of any dimension is 0, then str is an empty array.

  • If the size of any dimension is negative, then strings treats it as 0.

  • Beyond the second dimension, strings ignores trailing dimensions with a size of 1. For example, strings(3,1,1,1) produces a 3-by-1 vector of strings with no characters.

Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Size of each dimension, specified as a row vector of nonnegative integers. Each element of this vector indicates the size of the corresponding dimension:

  • If the size of any dimension is 0, then str is an empty array.

  • If the size of any dimension is negative, then strings treats it as 0.

  • Beyond the second dimension, strings ignores trailing dimensions with a size of 1. For example, strings([3,1,1,1]) produces a 3-by-1 vector of strings with no characters.

Example: sz = [2,3,4] creates a 2-by-3-by-4 array.

Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

See Also

| | | | | | | |

Topics

Introduced in R2016b

MATLAB Documentation

Support