STRING VARIABLE

STRING VARIABLE

Let Subcommand

Create a string variable from a list of strings and save it to the file dpzchf.dat.

The Dataplot READ command can optionally read character data. The READ command saves these character variables to the file "dpzchf.dat".

The STRING VARIABLE command allows you to add character variables to "dpzchf.dat" from a list of scalar strings.

You can specify whether you want Dataplot to overwrite the current contents of "dpzchf.dat" or append the new variable to the current contents of "dpzchf.dat".

To have the STRING VARIABLE command overwrite the current contents of "dpzchf.dat", enter

SET CHARACTER VARIABLE OVERWRITE

To have the STRING VARIABLE command append the new string variable to the current contents of "dpzchf.dat", enter

SET CHARACTER VARIABLE APPEND

LET <sout> = STRING VARIABLE <s1> ... <sk>
where <sout> is the name of the resulting string variable;
and <s1> ... <sk> is a list of one or more previously defined strings or literal text strings.

Literal text strings should be enclosed in quotes. If an argument on the right hand side of the equal sign is not enclosed in quotes, it will be assumed to be a previously defined string. If an argument is not enclosed in quotes and is not the name of a previously defined string, an error message will be returned and <sout> will not be created.

The TO syntax is supported for the argument list (see the Examples).

LET IX = STRING VARIABLE S1 S2 S3
LET IX = STRING VARIABLE S1 TO S10
LET IX = STRING VARIABLE "Group 1" "Group 2" "Group 3"
LET IX = STRING VARIABLE "Group 1" S2 "Group 3" S4

None

None

READ	=	Read variables from the terminal or a file.
READ STRING	=	Reads a string from a file.
STRING STARTS WITH	=	Check whether a string starts with a specified substring.
STRING ENDS WITH	=	Check whether a string starts with a specified substring.
LET FUNCTION	=	Defines a function.
LET STRING	=	Defines a string.
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.
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

2019/10

 
set string variable overwrite
let ix = string variable "Group 1" "Group 2"  "Group 3"
list dpzchf.dat
    

The following output is generated

 
       1
IX               3
Group 1
Group 2
Group 3
    

 
set string variable overwrite
let string s1 = Group 1
let string s2 = Group 2
let string s3 = Group 3
let ix = string variable s1 s2 s3
list dpzchf.dat
pause
    

The following output is generated

 
       1
IX               3
Group 1
Group 2
Group 3
    

 
.
set string variable append
let string s4 = Group 4
let string s5 = Group 5
let string s6 = Group 6
let iy = string variable s4 s5 s6
list dpzchf.dat
    

The following output is generated

 
       2
IX               3
IY               3
Group 1                  Group 4
Group 2                  Group 5
Group 3                  Group 6