Library /sys$common/syshlp/helplib.hlb  —  RTL Routines, OTS$  OTS$CVT_TL_L
    The Convert Logical Text to Integer routine converts an ASCII
    text string representation of a FORTRAN-77 L format to a signed
    integer.

    Format

      OTS$CVT_TL_L  fixed-or-dynamic-input-string

                    ,varying-output-value [,output-value-size]

1  –  Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2  –  Arguments

 fixed-or-dynamic-input-string

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor, fixed-length or dynamic string

    Input string containing an ASCII text representation of a
    FORTRAN-77 L format that OTS$CVT_TL_L converts to a signed
    integer value. The fixed-or-dynamic-input-string argument is
    the address of a descriptor pointing to the input string.

    Common ASCII text representations of a FORTRAN-77 logical are
    .TRUE., .FALSE., T, t, F, and f. In practice, an OTS$CVT_TL_L
    input string is valid if it adheres to the following syntax:

    <blanks>

        or

    [<blanks>][.]{T t F f}[<characters>]

    One of the letters T, t, F, or f is required. Other elements in
    the preceding syntax are defined as follows:

    Term         Description

    blanks       One or more blanks
    characters   One or more of any character

 varying-output-value

    OpenVMS usage:varying_arg
    type:         unspecified
    access:       write only
    mechanism:    by reference

    Signed integer that OTS$CVT_TL_L creates when it converts the
    ASCII text string. The varying-output-value argument is the
    address of the signed integer. The value of the output-value-size
    argument determines the size in bytes of the signed integer.

    OTS$CVT_TL_L returns -1 as the contents of the varying-output-
    value argument if the character denoted by "letter" is T or t.
    Otherwise, OTS$CVT_TL_L sets varying-output-value to zero.

 output-value-size

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       read only
    mechanism:    by value

    Number of bytes to be occupied by the signed integer created
    when OTS$CVT_TL_L converts the ASCII text string to an integer
    value. The output-value-size argument contains a value that
    equals the size in bytes of the output value. If output-value-
    size contains a zero or a negative number, OTS$CVT_TL_L returns
    an input conversion error.

    On VAX systems, valid values for the output-value-size argument
    are 1, 2, and 4. The value determines whether the integer value
    that OTS$CVT_TL_L creates is a byte, word, or longword.

    On Alpha and I64 systems, valid values for the output-value-
    size argument are 1, 2, 4, and 8. This value determines whether
    the integer value that OTS$CVT_TL_L creates is a byte, word,
    longword, or quadword.

    For VAX, Alpha, and I64 systems, if you omit the output-value-
    size argument, the default is 4 (longword).
Close Help