Library /sys$common/syshlp/helplib.hlb  —  RTL Routines, LIB$  LIB$MOVTC
    The Move Translated Characters routine moves the source
    string, character by character, to the destination string after
    translating each character using the specified translation table.
    LIB$MOVTC makes the VAX MOVTC instruction available as a callable
    routine.

    Format

      LIB$MOVTC  source-string ,fill-character ,translation-table

                 ,destination-string

1  –  Returns

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

2  –  Arguments

 source-string

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

    Source string to be translated and moved by LIB$MOVTC. The
    source-string argument is the address of a descriptor pointing
    to this source string.

 fill-character

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

    Fill character used to pad source-string to the length of
    destination-string. The fill-character argument is the address
    of a descriptor pointing to a string. The first character of this
    string is used as the fill character. The length of this string
    is not checked and fill-character is not translated.

 translation-table

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

    Translation table used by LIB$MOVTC. The translation-table
    argument is the address of a descriptor pointing to the
    translation table string. The translation table string is assumed
    to be 256 characters long.

    You can use any one of the translation tables supplied by HP,
    or you can create your own. Translation tables supplied by HP
    have names in the format LIB$AB_xxx_yyy, which represent the
    addresses of the 256-byte translation tables and can be accessed
    as external (string) variables. If a particular language cannot
    generate descriptors for external strings, then you must create
    them manually.

 destination-string

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

    Destination string into which LIB$MOVTC writes the translated
    source-string. The destination-string argument is the address of
    a descriptor pointing to this destination string.
Close Help