Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-39
MBCS_SHIFTSTRING_ Procedure
MBCS_SHIFTSTRING_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Consideration
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 1-byte alphabetic characters of the ASCII character set are case
shifted by this procedure.
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
bytestring input
STRING .EXT:ref:*
is a pointer to a buffer containing a properly formed text string that may contain any
mixture of 1-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.) The contents of the
bytestring pointer
are not altered by the shift operation.
#include <cextdecs(MBCS_SHIFTSTRING_)>
void MBCS_SHIFTSTRING_ ( char *bytestring
,short bytecount
,short casebit
,[ short charset ]
,[ short *charinfo ] );
CALL MBCS_SHIFTSTRING_ ( bytestring ! i
,bytecount ! i
,casebit ! i
,[ charset ] ! i
,[ charinfo ] ); ! o