HELPLIB.HLB  —  RTL Routines, LIB$  LIB$ANALYZE_SDESC_64
    (Alpha and I64 only.) The Analyze String Descriptor routine
    extracts the length and the address at which the data starts
    for a variety of 32-bit and 64-bit string descriptor classes.

    Format

      LIB$ANALYZE_SDESC_64  input-descriptor ,data-length

                            ,data-address [,descriptor-type]

1  –  Corresponding JSB Entry Point

      LIB$ANALYZE_SDESC_R2   Refer to the LIB$ANALYZE_SDESC routine
                            for information about the JSB entry
                            point, LIB$ANALYZE_SDESC_R2. This JSB
                            entry point returns 64-bit results on
                            Alpha and I64 systems.

2  –  Returns

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

3  –  Arguments

 input-descriptor

    OpenVMS usage:descriptor
    type:         longword (unsigned) or quadword (unsigned)
    access:       read only
    mechanism:    by reference

    Input descriptor from which LIB$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).

 data-length

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

    Length of the data; LIB$ANALYZE_SDESC_64 extracts this length
    value from the input descriptor. The data-length argument is the
    address of an unsigned quadword integer into which LIB$ANALYZE_
    SDESC_64 writes the length.

 data-address

    OpenVMS usage:address
    type:         quadword (unsigned)
    access:       write only
    mechanism:    by reference

    Starting address of the data; LIB$ANALYZE_SDESC_64 extracts this
    address from the input descriptor. The data-address argument is
    the address of an unsigned quadword into which LIB$ANALYZE_SDESC_
    64 writes the starting address of the data.

 descriptor-type

    OpenVMS usage:longword_unsigned
    type:         longword (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
    longword integer to which LIB$ANALYZE_SDESC_64 writes a 0 for a
    32-bit input descriptor or a 1 for a 64-bit descriptor.

    This argument is optional.
Close Help