Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-173
STRING_UPSHIFT_ Procedure
STRING_UPSHIFT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Example
Related Programming Manual
Summary
The STRING_UPSHIFT_ procedure changes all the alphabetic characters in a string to
upper case. Nonalphabetic characters remain unchanged.
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
error returned value
INT
indicates the outcome of the operation. Possible values are:
0=Operation successful
1=(reserved)
2=Parameter error
3=Bounds error
4=String too large to fit in out-string
in-string:length input:input
STRING .EXT:ref:*, INT:value
is the character string which is to have all alphabetic characters changed to upper
case.
in-string must be exactly length bytes long. The maximum acceptable
value of
length is 32,767.
#include <cextdecs(STRING_UPSHIFT_)>
short STRING_UPSHIFT_ ( char *in-string
,short length
,char *out-string
,short maxlen );
error := STRING_UPSHIFT_ ( in-string:length ! i:i
,out-string:maxlen ); ! o:i