SQL/MP Programming Manual for C

Character Processing Rules (CPRL) Procedures
HP NonStop SQL/MP Programming Manual for C—429847-008
11-23
CPRL_UPSHIFT_
filename
is the Guardian file name in external format containing the collation object. The file
code for filename must be 199.
filenamelength
is the length in bytes of filename.
cprladdr
is the address of the collation object if 0 (zero) is returned. Otherwise, cprladdr
is set to an invalid address.
CPRL_UPSHIFT_
The CPRL_UPSHIFT_ procedure upshifts a character string according to the upshift
rules in the specified SQL collation or collation object.
The CPRL_UPSHIFT_ procedure returns these values:
inputstring
is an array containing the data to be upshifted.
inputstringlength
is the number of bytes in inputstring to be upshifted.
shiftedstring
is an array in which CPRL_UPSHIFT_ returns the upshifted string.
The values for inputstring and shiftedstring can be equal, but other
values can cause unpredictable results.
#include <cextdecs(CPRL_UPSHIFT_)>
short CPRL_UPSHIFT_ (
char *inputstring /* i */
,short inputstringlength /* i */
,char *shiftedstring /* o */
,short shiftedstringmaxlength /* i */
,short *shiftedstringlength /* o */
,long cprladdr ); /* i */
Code Description
0 The operation was successful.
–2 The SQL collation or collation object is invalid.
–4 The version of the SQL collation or collation object is not supported.
–20 The user-specified buffer is not large enough to receive the returned string.