Library /sys$common/syshlp/helplib.hlb  —  RTL Routines, LIB$  LIB$SCANC
    The Scan for Characters and Return Relative Position routine is
    used to find a specified set of characters in the source string.
    LIB$SCANC makes the VAX SCANC instruction available as a callable
    routine.

    Format

      LIB$SCANC  source-string ,table-array ,byte-integer-mask

1  –  Returns

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

    Relative position in the source string of the character that
    terminated the operation, or zero if the terminator character is
    not found. If the source string has a zero length, then a zero is
    returned.

2  –  Arguments

 source-string

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

    Source string used by LIB$SCANC to index into a table. The
    source-string argument contains the address of a descriptor
    pointing to this source string.

 table-array

    OpenVMS usage:vector_mask_byte
    type:         byte (unsigned)
    access:       read only
    mechanism:    by reference, array reference

    Table that LIB$SCANC indexes into and performs a logical AND
    operation with the byte-integer-mask byte. The table-array
    argument contains the address of an unsigned byte array that
    is this table.

 byte-integer-mask

    OpenVMS usage:mask_byte
    type:         byte (unsigned)
    access:       read only
    mechanism:    by reference

    Mask on which a logical AND operation is performed with bytes in
    table-array. The byte-integer-mask argument contains the address
    of an unsigned byte that is this mask.
Close Help