_STRLEN_SPP()--Determine Character String Length for IBM PASE for i
Syntax
#include <as400_protos.h> size_t _STRLEN_SPP(const ILEpointer *string);
Default Public Authority: *USE
Library: Standard C Library (libc.a)
Threadsafe: Yes
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
- _STRLEN_SPP can reference any memory addressable through a tagged space
pointer, which need not be in the IBM PASE for i address space.
- _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
API introduced: V4R5