Guardian Procedure Calls Reference Manual

STRING_UPSHIFT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
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
#include <cextdecs(STRING_UPSHIFT_)>
short STRING_UPSHIFT_ ( char *in-string
,short length
,char *out-string
,short maxlen );
Syntax for TAL Programmers
error := STRING_UPSHIFT_ ( in-string:length ! i:i
,out-string:maxlen ); ! o:i
Parameters
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.
out-string:maxlen
output:input
STRING .EXT:ref:*, INT:value
returns the resultant string. The same buffer can be used for in-string and out-string.
maxlen is the length in bytes of the string variable out-string. maxlen must be at least
as large as the length of the input string.
Returned Value
INT
Outcome of the operation:
Operation successful.0
(Reserved)1
Parameter error.2
1404 Guardian Procedure Calls (S)