Guardian Procedure Calls Reference Manual

MBCS_MB_TO_SB_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Summary
The MBCS_MB_TO_SB_ procedure and the companion MBCS_SB_TO_MB_ procedure allow
conversion of the ninety-four displayable characters of the ASCII character set between one-byte
ASCII and characters of the specified MBCS. The MBCS_MB_TO_SB_ procedure converts multibyte
characters to the corresponding one-byte ASCII characters.
Syntax for C Programmers
#include <cextdecs(MBCS_MB_TO_SB_)>
void MBCS_MB_TO_SB_ ( char *mbytestring
,short mbytecount
,char *sbytestring
,short sbytecount
,short *rbytecount
,[ short charset ]
,[ short *charinfo ] );
Syntax for TAL Programmers
CALL MBCS_MB_TO_SB_ ( mbytestring:mbytecount ! i:i
,sbytestring:sbytecount ! o:i
,rbytecount ! o
,[ charset ] ! i
,[ charinfo ] ); ! o
Parameters
mbytestring:mbytecount
input:input
STRING .EXT:*, INT:value
specifies a text string with ASCII-equivalent characters in the multibyte character set identified
by charset. mbytestring is the input text string to be converted by this procedure; it must
be exactly mbytecount bytes long.
sbytestring:sbytecount
output:input
STRING .EXT:*, INT:value
returns the converted text string containing one-byte characters. The string variable
sbytestring must be exactly sbytecount bytes long.
rbytecount
output
INT .EXT:ref:1
returns the actual byte length of the converted text string contained in sbytestring.
MBCS_MB_TO_SB_ Procedure 809