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).