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 2 Vol 1

CHECK NAMES

Name:
    CHECK NAMES (LET)
Type:
    Let Subcommand
Purpose:
    Given a list of names, check if any names are not already defined.
Description:
    Sometimes when writing general purpose macros it may be useful to know if certain names have been defined. This can be either because certain variables or parameters are expected to be defined or because you want to use a particular name and you want to ensure that it is not already being used.
Syntax:
    LET <iflag> = CHECK NAMES <name1> <name2> ... <namek>
    where <name1> <name2> ... <namek> is a list of 1 to k names;
    and     <iflag> is a parameter where the status is saved.

    If all names are already defined, <iflag> will be set to 1. If one or more names are undefined, <iflag> will be set to 0.

Examples:
    LET IFLAG = CHECK NAMES Y X
Note:
    The CALL EXIT and CALL EXIT ALL commands were added to allow you to exit a macro. The status flag from the CHECK NAMES command can be used to determine whether you want to exit from a macro or continue.
Default:
    None
Synonyms:
    None
Related Commands: Applications:
    Data Management
Implementation Date:
    2015/06
Program:
    skip 25
    read berger1.dat y x bat
    let iflag = check names y x bat s
        
    The following output is generated
    ***** ERROR IN CHECK NAME--
          NAME S        WAS NOT FOUND IN THE CURRENT NAME LIST.
     
    THE STATUS FLAG FOR CHECK NAME =        0
        

Privacy Policy/Security Notice
Disclaimer | FOIA

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

Date created: 06/30/2015
Last updated: 06/30/2015

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