STRING WORD

STRING WORD

Let Subcommand

Extract a specified word from a string.

There may be times when it is useful to extract the individual words in a string.

Dataplot delineates words in a string by spaces. It will treat non-printing characters in the string as spaces. That is, any character in the string with an ASCII collating index less than or equal to 32 or greater than 127 will be treated as a space. In particular, tabs will be treated as spaces. However, hyphens and other special characters such as "&" will not be treated as word boundaries.

LET <sout> = STRING WORD <sorg> <nword>
where <sout> is the name of the resulting string;
            <sorg> is the name of the original string;
and <nword> is the index of the word to extract.

LET SOUT = STRING WORD S1 NWORD
LET SOUT = STRING WORD S1 5

The name of the new string can be the same as the original string. For example,
LET FNAME = STRING WORD FNAME NWORD

In this case, FNAME will now contain the extracted word rather than the original string.

The string on the right hand side of the equal sign must be a previously existing string. That is, expressions are not allowed. For example, instead of
LET FNAME = STRING WORD "a b c d" 2

you need to do

LET STRING SORG = a b c d
LET FNAME = STRING WORD SORG 2


The word index position can be either a parameter or a numeric value. However, it cannot be a numeric expression. So

LET FNAME = STRING WORD SORG 5
LET FNAME = STRING WORD SORG NWORD


are both allowed but

LET FNAME = STRING WORD SORG NWORD/2

is not allowed. You would need to enter this as

LET NWORD = NWORD/2
LET FNAME = STRING WORD FNAME NWORD


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.

If the requested word is less than one or is greater than the number of words in the string, an error is reported and the requested string will not be created.

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

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.
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.
GROUP LABEL	=	Define the text for group labels.

Data Management

10/2010

let string s = funnel ramp cone square
.
feedback off
print "String s = ^s"
let nword = number of words s
loop for k = 1 1 nword
    let s^k = string word s k
    print "String ^k = ^s^k"
end of loop
feedback on