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 VSI, or you can create your own. Translation tables supplied by VSI 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.