SQL/MP Programming Manual for C

Character Processing Rules (CPRL) Procedures
HP NonStop SQL/MP Programming Manual for C—429847-008
11-4
CPRL_AREALPHAS_
exceptcharaddr
is set as follows:

If the call is successful, all scanned characters are in the character class
defined by the specified SQL collation or collation object, and
exceptcharaddr is set as follows:
exceptcharaddr = inputstring + inputstringlength

If –6 is returned, the first character in inputstring not in the specified
character class was found; exceptcharaddr is set to the address of this
character.

For other error codes, exceptcharaddr is set to an invalid address.
cprladdr
is a pointer to the SQL collation or collation object.
CPRL_AREALPHAS_
The CPRL_AREALPHAS_ procedure determines if all characters in a string are in the
ALPHAS character class according to a specified SQL collation or collation object. You
can also use this procedure to scan for the first character in the string that is not in the
ALPHAS character class.
The CPRL_AREALPHAS_ procedure returns these values:
inputstring
is an array containing the string to be scanned.
inputstringlength
is the number of bytes to be scanned in inputstring.
#include <cextdecs(CPRL_AREALPHAS_)>
short CPRL_AREALPHAS_ (
char *inputstring /* i */
,short inputstringlength /* i */
,long *exceptcharaddr /* 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.
–6 The input string contains a character not in the specified character class.