SED navigation bar go to SED home page go to Dataplot home page go to NIST home page SED Home Page SED Staff SED Projects SED Products and Publications Search SED Pages
Dataplot Vol 1 Vol 2

SET STRING VARIABLE

Name:
    STRING VARIABLE (SET)
Type:
    Set Subcommand
Purpose:
    Specify whether the READ and STRING VARIABLE commands will overwrite the contents of the dpzchf.dat file or append the new data to the current contents of the dpzchf.dat file.
Description:
    The READ command can optionally read character variables (SET CONVERT CHARACTER). Dataplot saves the character variables in the file "dpzchf.dat". In addition, the LET ... = STRING VARIABLE command can be used to create a character variable from a list of strings. This variable will be saved in the "dpzchf.dat" as well.

    By default, Dataplot overwrites the current contents of the "dpzchf.dat" file whenever a READ or STRING VARIABLE command creates new character variables. To have these commands append the contents of the new character variables to the current contents of "dpzchf.dat", enter the command

      SET STRING VARIABLE APPEND

    To reset the default of overwriting the current contents of "dpzchf.dat", enter

      SET STRING VARIABLE OVERWRITE
Syntax:
    SET STRING VARIABLE <OVERWRITE/APPEND>
    where OVERWRITE replaces the current contents of "dpzchf.dat" and APPEND appends to the current contents of "dpzchf.dat".
Examples:
    SET STRING VARIABLE APPEND
    SET STRING VARIABLE OVERWRITE
Default:
    None
Synonyms:
    None
Related Commands:
    STRING VARIABLE = Create a character variable from a list of
    READ = Read numeric/character variables from a file.
Applications:
    Character Data
Implementation Date:
    2019/09
Program:
     
    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
        

Privacy Policy/Security Notice
Disclaimer | FOIA

NIST is an agency of the U.S. Commerce Department.

Date created: 01/22/2020
Last updated: 01/22/2020

Please email comments on this WWW page to alan.heckert@nist.gov.