_STRLEN_SPP()--Determine Character String Length for IBM PASE for i

 #include <as400_protos.h>

 size_t _STRLEN_SPP(const ILEpointer  *string);

Note: This function can only be used in an IBM^® i PASE program. See the IBM PASE for i topic collection for more information about creating IBM PASE for i programs.

The _STRLEN_SPP() determines the length of a null-terminated character string. It performs the same operation as the strlen function, but uses a 16-byte tagged space pointer to locate the string.

Parameters

string

(Input) Pointer to character string. string is the 16-byte aligned address of a tagged space pointer to the character string.

Authorities

_STRLEN_SPP requires no authority.

Return Value

_STRLEN_SPP returns length of the character string.

Error Conditions

Any error is reported with an IBM i exception message that the system converts to an IBM PASE for i signal. See IBM PASE for i Signal Handling for information about handling IBM i exceptions.

Usage Notes

1. _STRLEN_SPP can reference any memory addressable through a tagged space pointer, which need not be in the IBM PASE for i address space.
   
   
2. _STRLEN_SPP is implemented with a kernel system call, so it generally runs slower than strlen.

Related Information

• _CVTSPP()--Convert Space Pointer for IBM PASE for i
• _SETSPP() and _SETSPP_TS64()--Set Space Pointer for IBM PASE for i
• _SETSPPM()--Set Multiple Space Pointers for IBM PASE for i

[ Back to top | IBM PASE for i APIs | APIs by category ]