strsplitPad#

Purpose#

Splits a string vector into a string array of the individual tokens. Pads on the right with null strings.

Format#

sa = strsplitPad(sv, n_cols)#
Parameters:
  • sv (Nx1 string array) – data

  • n_cols (scalar) – number of columns of output string array.

Returns:

sa (Nxn_cols string array) – original string vectors, split into individual tokens.

Examples#

string sv = {
   "alpha beta gamma",
   "delta, epsilon, zeta, eta",
   "theta iota kappa"
};

 sa = strsplitPad(sv, 4);

After the code above, sa will be equal to:

"alpha"    "beta" "gamma"    ""
"delta" "epsilon"  "zeta" "eta"
"theta"    "iota" "kappa"    ""

Remarks#

Rows containing more than n_cols tokens are truncated and rows containing fewer than n_cols tokens are padded on the right with null strings. The following characters are considered delimiters between tokens:

space

ASCII 32

tab

ASCII 9

comma

ASCII 44

newline

ASCII 10

carriage return

ASCII 13

Tokens containing delimiters must be enclosed in single or double quotes or parentheses. Tokens enclosed in single or double quotes will NOT retain the quotes upon translation. Tokens enclosed in parentheses WILL retain the parentheses after translation. Parentheses cannot be nested.

See also

Functions strsplit()