VMS Help RTL Routines, STR$, STR$ANALYZE_SDESC_64  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    (Alpha only.) The Analyze String Descriptor routine extracts the
    length and starting address of the data for a variety of string
    descriptor classes.

    Format

      STR$ANALYZE_SDESC_64  input-descriptor ,integer-length

                            ,data-address [,descriptor-type]

1 - Corresponding JSB Entry Point

      STR$ANALYZE_SDESC_R1

                            Refer to the STR$ANALYZE_SDESC routine

                            for information about the JSB entry

                            point, STR$ANALYZE_SDESC_R1. This JSB

                            entry point returns 64-bit results on

                            Alpha systems.

2 - Returns

    OpenVMS usage:quadword_unsigned
    type:         quadword (unsigned)
    access:       write only
    mechanism:    by value

    Length of the data. The return value is the same value returned
    to the integer-length argument.

3 - Arguments

 input-descriptor

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Input descriptor from which STR$ANALYZE_SDESC_64 extracts the
    length of the data and the address at which the data starts. The
    input-descriptor argument is the address of a descriptor pointing
    to the input data. The input descriptor can be a longword
    (unsigned) or a quadword (unsigned).

 integer-length

    OpenVMS usage:quadword_unsigned
    type:         quadword (unsigned)
    access:       write only
    mechanism:    by reference for CALL entry point, by value for JSB
                  entry point

    Length of the data; this length is extracted from the descriptor
    by STR$ANALYZE_SDESC_64. The integer-length argument is the
    address of an unsigned quadword integer into which STR$ANALYZE_
    SDESC_64 writes the data length.

 data-address

    OpenVMS usage:address
    type:         quadword (unsigned)
    access:       write only
    mechanism:    by reference for CALL entry point, by value for JSB
                  entry point

    Address of the data; this address is extracted from the
    descriptor by STR$ANALYZE_SDESC_64. The data-address argument
    is an unsigned quadword into which STR$ANALYZE_SDESC_64 writes
    the address of the data.

 descriptor-type

    OpenVMS usage:word_unsigned
    type:         word (unsigned)
    access:       write only
    mechanism:    by reference

    Flag value indicating the type of input descriptor. The
    descriptor-type argument contains the address of an unsigned
    word integer to which STR$ANALYZE_SDESC_64 writes a zero (0) for
    a 32-bit input descriptor or a one (1) for a 64-bit descriptor.

    This argument is optional.