_CVTSPP()--Convert Space Pointer for IBM PASE for i
Syntax
#include <as400_protos.h> void* _CVTSPP(const ILEpointer *source);
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.
The _CVTSPP() function converts the teraspace address in a tagged space pointer to an equivalent IBM PASE for i memory address.
Parameters
- source
- (Input) Pointer to a tagged space pointer or 16-byte null pointer. The source address must 16-byte aligned.
Authorities
_CVTSPP requires no authority.
Return Value
_CVTSPP returns the IBM PASE for i memory address equivalent of the input tagged space pointer. The result is zero (null) if the input is a 16-byte null pointer or a tagged space pointer that does not contain the teraspace address equivalent of some valid IBM PASE for i memory address.
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
- _CVTSPP returns an IBM PASE for i memory address regardless of whether there is currently any memory at that address (as long as the input tagged pointer contains the teraspace address equivalent of a valid IBM PASE for i memory address).
Related Information
- _CVTTS64()--Convert Teraspace Address for IBM PASE for i
- _GETTS64() and _GETTS64_SPP--Get Teraspace Address for IBM PASE for i
- _GETTS64M()--Get Multiple Teraspace Addresses 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