Guardian Procedure Calls Reference Manual

MBCS_SHIFTSTRING_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Related Programming Manual
Summary
The MBCS_SHIFTSTRING_ procedure upshifts or downshifts all alphabetic characters in a multibyte
character set (MBCS) string. Both multibyte alphabetic characters of the specified MBCS and
one-byte alphabetic characters of the ASCII character set are case shifted by this procedure.
Syntax for C Programmers
#include <cextdecs(MBCS_SHIFTSTRING_)>
void MBCS_SHIFTSTRING_ ( char *bytestring
,short bytecount
,short casebit
,[ short charset ]
,[ short *charinfo ] );
Syntax for TAL Programmers
CALL MBCS_SHIFTSTRING_ ( bytestring ! i
,bytecount ! i
,casebit ! i
,[ charset ] ! i
,[ charinfo ] ); ! o
Parameters
bytestring
input
STRING .EXT:ref:*
is a pointer to a buffer containing a properly formed text string that may contain any mixture
of one-byte and MBCS characters. A properly formed text string may not begin with the second
or subsequent byte of an MBCS character or end with any byte of an MBCS character other
than the last. (See the MBCS_TRIMFRAGMENT_ Procedure (page 826).) The contents of the
bytestring pointer are not altered by the shift operation.
bytecount
input
INT:value
is an integer variable containing the length in bytes of the text string bytestring.
casebit
input
INT:value
is a variable indicating the type of case shift to be applied to the one-byte alphabetic characters
in bytestring. When the case bit (bit <15>) is set to 0, an upshift is requested; when the
case bit is set to 1, a downshift is requested.
MBCS_SHIFTSTRING_ Procedure 815