splitlines - Split strings at newline characters - MATLAB (original) (raw)
Main Content
Split strings at newline characters
Syntax
Description
[newStr](#bu55fi1-newStr) = splitlines([str](#bu55fi1-str)) splits str at newline characters and returns the result as the output array newStr.
splitlines splits at actual newline characters, not at the literal \n. To split a string that contains\n, first use compose and then usesplitlines.
Examples
Split a string at a newline character. When the literal \n represents a newline character, convert it to an actual newline using the compose function. Then use splitlines to split the string at the newline character.
Create a string in which two lines of text are separated by \n. You can use + to concatenate text onto the end of a string.
str = "In Xanadu did Kubla Khan"; str = str + "\n" + "A stately pleasure-dome decree"
str = "In Xanadu did Kubla Khan\nA stately pleasure-dome decree"
Convert \n into an actual newline character. Although str displays on two lines, str is a 1-by-1 string containing both lines of text.
str = "In Xanadu did Kubla Khan A stately pleasure-dome decree"
Split str at the newline character. newStr is a 1-by-2 string array. Each element contains one line of the text.
newStr = 2×1 string "In Xanadu did Kubla Khan" "A stately pleasure-dome decree"
Create a character vector and split it at newline characters. The newline function returns the newline character, char(10).
chr = 'Whose woods these are I think I know.'; chr = [chr newline 'His house is in the village though;']
chr = 'Whose woods these are I think I know. His house is in the village though;'
C = 2×1 cell {'Whose woods these are I think I know.'} {'His house is in the village though;' }
Input Arguments
Input text, specified as a string array, a character vector, or a cell array of character vectors. If str is a string array or cell array of character vectors, then each element of str must contain the same number of newlines.
Output Arguments
Output text, returned as a string array or a cell array of character vectors. newStr has one more dimension thanstr. The size of the new dimension is one more than the number of newlines in a string element. splitlines assigns the results of the split along the new dimension. For example, ifstr is a 2-by-3 string array, and each string has three newline characters, thennewStr is a2-by-3-by-4 array.
If the input array str is a string array, then so isnewStr. Otherwise, newStr is a cell array of character vectors.
Tips
If the elements of a string array have different numbers of newline characters, use afor-loop to access the string elements individually and split them.
Extended Capabilities
Thesplitlines function fully supports tall arrays. For more information, see Tall Arrays.
Version History
Introduced in R2016b