Guardian Procedure Calls Reference Manual

MBCS_SB_TO_MB_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Summary
The MBCS_SB_TO_MB_ procedure and the companion MBCS_MB_TO_SB_ procedure are provided
to 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_SB_TO_MB_ procedure converts
one-byte ASCII characters to the corresponding multibyte characters.
Syntax for C Programmers
#include <cextdecs(MBCS_SB_TO_MB_)>
void MBCS_SB_TO_MB_ ( char *sbytestring
,short sbytecount
,char *mbytestring
,short mbytecount
,short *rbytecount
,[ short charset ]
,[ short *charinfo ] );
Syntax for TAL Programmers
CALL MBCS_SB_TO_MB_ ( sbytestring:sbytecount ! i:i
,mbytestring:mbytecount ! o:i
,rbytecount ! o
,[ charset ] ! i
,[ charinfo ] ); ! o
Parameters
sbytestring:sbytecount
input:input
STRING .EXT:*, INT:value
specifies a text string with one-byte ASCII characters. sbytestring is the input text string to
be converted by this procedure; it must be exactly sbytecount bytes long.
mbytestring:mbytecount
output:input
STRING .EXT:*, INT:value
returns the converted text string containing multibyte characters. The string variable
mbytestring must be exactly mbytecount bytes long.
rbytecount
output
INT .EXT:ref:1
returns the actual byte length of the converted text string contained in mbytestring.
MBCS_SB_TO_MB_ Procedure 813