STRING SPLIT

STRING SPLIT

Let Subcommand

Extract the individual words from a currently existing string.

This command is used to extract the individual words from a string.

This command is an alternative to using STRING WORD. STRING WORD is used to extract a specific word in the string while STRING SPLIT will extract all the words in a string to individual strings. Note that only the base name will be specified. For example, if you specify SOUT as the base name and there are three words in the original string, then string SOUT1 will contain the first word, SOUT2 will contain the second word, and SOUT3 will contain the third word.

In Dataplot, spaces are used to separate words.

LET <sout> = STRING SPLIT <sorg>
where <sorg> is the name of a pre-existing string;
and     <sout> is the base name of the resulting strings.

The <sout> defines the base name. An integer index will be appended to the base name for each string (the index starts at 1).

LET STBASE = STRING SPLIT SORG

The original string being processed must be a pre-existing string. If you want to split literal text, you need to do something like
LET STRING SORG = xxxx yyyy zzzz
LET SOUT = STRING SPLIT SORG


Using

LET SOUT = STRING SPLIT xxxx yyyy zzzz

will not work. It will try to see if "xxxx" is the name of currently defined string. If it is not, no new strings will be created. Enclosing the literal text in quotes will not make this work.

The name on the left hand side of the equal sign may be a previously existing string. However, if it is a previously existing parameter, variable, or matrix name, an error will be reported and the requested string will not be created.

By default, Dataplot uses a space as the word delimiter. You can specify an alternative character to be the word delimiter with the command
SET WORD DELIMITER <char>

with <char> denoting the character to use as the word delimiter.

Starting with the 2020/08 version of Dataplot, the parameter NUMBWORD is automatically created. This parameter contains the number of strings that are created by this command.

The total number of characters that DATAPLOT can use for storing functions and strings is set when DATAPLOT is built. The current default (11/2008) is 50,000 characters. Previous versions may set this limit at 1,000 or 10,000 characters. This limit applies to the combined number of characters for all functions and strings.

None

None

LET FUNCTION	=	Defines a function.
LET STRING	=	Defines a string.
READ STRING	=	= Reads a string from a file.
STRING STARTS WITH	=	Check whether a string starts with a specified substring.
STRING REMOVE SPACE	=	Remove spaces from a string.
STRING REMOVE PUNCTUATION	=	Remove punctuation from a string.
STRING DELETE	=	Remove user specifed characters from a string.
NUMBER OF WORDS	=	Return the number of words in a string.
UPPER CASE	=	Convert a string to upper case.
LOWER CASE	=	Convert a string to lower case.
LET FUNCTION	=	Defines a function.
LET STRING	=	Defines a string.
READ STRING	=	Reads a string from a file.
SUBSTITUTE CHARACTER (^)	=	Substitute the value of a string or parameter.
CONCATENATE CHARACTER (&)	=	Concatenate two strings.
SUBTRING	=	Extract a substring from an existing string.
BLANK STRING	=	Create a blank string.
STRING INDEX	=	Extract the start/stop positions of a substring within a string.
STRING CONCATENATE	=	Concatenate one or more previously defined strings.
STRING EDIT	=	Edit a string.
STRING MERGE	=	Insert a string into another string without overwrite.
STRING LENGTH	=	Return the length of a string.
CHARACTER	=	Convert numeric values to strings based on the ASCII collating sequence.
ICHAR	=	Convert a string to numeric values based on the ASCII collating sequence.

Data Management

2018/10
2020/08: Automatically save NUMBWORD parameter

 
LET STRING SORG = X1 X2 X3 X4 X5
LET SNAME = STRING SPLIT SORG
PRINT SNAME1 SNAME2 SNAME3 SNAME4 SNAME5
    

The following output is returned

 FUNCTIONS--

     SNAME1  --X1
     SNAME2  --X2
     SNAME3  --X3
     SNAME4  --X4
     SNAME5  --X5