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

DIGITS TO STRING

Name:
    DIGITS TO STRING
Type:
    Let Subcommand
Purpose:
    Convert a vector of positive integers to a string.
Description:
    Given a vector that contains the values 2, 3, and 5, the DIGITS TO STRING command creates the string

      X2*X3*X5

    This is a utility routine used by the macros that run the 10-step analysis of 2-level factorial designs.

    Dataplot will add 0.5 to the numbers in the vector and then take the absolute value before truncating to the integer value.

Syntax:
    LET <sout> = DIGITS TO STRING <y>
    where <sout> is the name of the resulting string;
    and     <y> is a variable containing integer values.
Examples:
    LET SOUT = DIGITS TO STRING Y
Note:
    The name on the right hand side of the equal sign must be a previously existing variable. If it is a previously existing parameter, string, or matrix name, an error will be reported and the requested string will not be created.

    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.

Note:
    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.
Default:
    None
Synonyms:
    None
Related Commands:
    DIGITS = Strip out the individual digits for the integer portion of a number.
    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.
    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 REPLACE = Insert the contents of one string into another string at a specified position.
    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.
Applications:
    Data Management
Implementation Date:
    2015/03
Program:
     
    let y = data 2 3 5
    let stout = digits to string y
    print stout
        
    The following output is generated
     
     FUNCTIONS--
    
         STOUT   --X2*X3*X5
        

Privacy Policy/Security Notice
Disclaimer | FOIA

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

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

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