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

SEARCH

Name:
    SEARCH
Type:
    Support Command
Purpose:
    Search a file for a string.
Syntax 1:
    SEARCH <file name> <string>
    where <file name> is the file to be searched;
    and <string> is the string to search for.

    This syntax prints all lines where a match is found.

Syntax 2:
    SEARCH1 <file name> <string>
    where <file name> is the file to be searched;
    and where <string> is the string to search for.

    This syntax prints the first line where a match is found.

Syntax 3:
    SEARCHB <file name> <string>
    where <file name> is the file to be searched;
    and <string> is the string to search for.

    This syntax prints from the first line where a match is found to the next blank line.

Syntax 4:
    SEARCHDA <file name> <string>
    where <file name> is the file to be searched;
    and <string> is the string to search for.

    This syntax prints from the first line where a match is found to the next dashed line.

Syntax 5:
    SEARCH REFERENCE <string>
    where <string> is the string to search for.

    This syntax searches the file refman.tex located in the Dataplot HELP directory. This file is used by the WEB HELP command to access the Dataplot reference manual on the Dataplot web pages.

Syntax 6:
    SEARCH HANDBOOK <string>
    where <string> is the string to search for.

    This syntax searches the file handbk.tex located in the Dataplot HELP directory. This file is used by the WEB HANDBOOK command to access the NIST/SEMATECH e-Handbook of Statistics web pages.

Syntax 7:
    SEARCH DIRECTORY <string>
    where <string> is the string to search for.

    This syntax searches the file dpdirf.tex located in the Dataplot HELP directory. This file contains a one line description of Dataplot commands sorted by category.

Syntax 8:
    SEARCH DICTIONARY <string>
    where <string> is the string to search for.

    This syntax searches the file dpdicf.tex located in the Dataplot HELP directory. This file contains a one line description of Dataplot commands sorted alphabetically.

Examples:
    SEARCH PLOTCALIB. PLOT
    SEARCH PROG.PLOTLAB READ
    SEARCH REFERENCE MEAN PLOT
    SEARCH HANDBOOK RELIABILITY
Note:
    In versions prior to 2018/04, only the first word of <string> was matched. For example, SEARCH REFERENCE MEAN PLOT would find all lines in refman.tex that contain the word MEAN.

    Starting with the 2018/04 version, SEARCH REFERENCE MEAN PLOT will now only match the lines containing the phrase MEAN PLOT. Note that words MEAN PLOT must appear contiguously (i.e., as a single phrase) on the line. It does not do a separate search for MEAN and then for PLOT and it does not match lines where MEAN and PLOT do not appear together. For example, "MEAN OF THE PLOT" would not be a match for "MEAN PLOT".

Note:
    Dataplot will save the line number of the first match in the parameter LINENUMB.
Note:
    Only the first 80 characters of the line will be printed.
Note:
    The search is not case sensitive.
Note:
    The FOR clause can be used to search a restricted part of the file. For example,

      SEARCH PROG.PLOTLAB PLOT FOR I = 1 1 200

    searches only the first 200 lines of the file.

Note:
    DATAPLOT has no restrictions on the file name other than it be a valid file name on the local operating system and that it contain a period "." in the file name itself or as a trailing character. DATAPLOT strips off trailing periods on those systems where it is appropriate to do so. On systems where trailing periods can be a valid file name (e.g., Unix), DATAPLOT tries to open the file with the trailing period. If this fails, it then tries to open the file with the trailing period stripped off.
Note:
    File names are case sensitive on Unix file systems. For Unix, DATAPLOT attempts to open the file as given. If this fails, it attempts to open the file as all upper case characters. If this fails, it attempts to open the file as all lower case characters. All other currently supported systems are not case sensitive regarding file names.

    As a further caution for Unix hosts, certain expansion characters (specifically ~ to refer to your home directory) are interpreted by the shell and are not recognized by the Fortran compiler. These expansion characters are interpreted as literal characters and do not yield the intended file name.

Default:
    None
Synonyms:
    SEARCHALL is a synonym for SEARCH

    ? is a synonym for SEARCH REFERENCE
    SEARCH RM is a synonym for SEARCH REFERENCE
    SEARCH is a synonym for SEARCH REFERENCE

    ??? is a synonym for SEARCH HANDBOOK SEARCH HB is a synonym for SEARCH HANDBOOK SEARCH HANDBK is a synonym for SEARCH HANDBOOK

    SEARCH DIR is a synonym for SEARCH DIRECTORY
    SEARCH DIRE is a synonym for SEARCH DIRECTORY
    SEARCH DIC is a synonym for SEARCH DICTIONARY
    SEARCH DICT is a synonym for SEARCH DICTIONARY

Related Commands:
    LIST = Print the contents of the file.
    WEB HELP = Access Dataplot's web-based documentation.
    WEB HANDBOOK = Access the NIST/SEMATECH Handbook of Statistical Methods web pages.
Applications:
    Documentation
Implementation Date:
    1988/01
    1988/08: Support for DICTIONARY and DIRECTORY searches
    1994/01: Support for SEARCH1 option
    2003/02: Support for saving LINENUMB
    2018/04: Support for REFERENCE and HANDBOOK searches
    2018/04: Support for multi-word searches
    2018/04: Add various synonyms
Program: 
     
SEARCH REFERENCE MEAN PLOT
WEB HELP MEAN PLOT

Privacy Policy/Security Notice
Disclaimer | FOIA

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

Date created: 04/09/2018
Last updated: 04/09/2018
Please email comments on this WWW page to alan.heckert@nist.gov.