_CVTTS64()--Convert Teraspace Address for IBM PASE for i


  Syntax
 #include <as400_protos.h>

 void* _CVTTS64(ts64_t 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 _CVTTS64() function converts a 64-bit teraspace address to an equivalent IBM PASE for i memory address.


Parameters

source
(Input) A 64-bit teraspace address.

Authorities

_CVTTS64 requires no authority.


Return Value

_CVTTS64 returns the IBM PASE for i memory address equivalent of the 64-bit teraspace address. The result is zero (null) if the input is either zero or an address that cannot contain IBM PASE for i memory.


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. _CVTTS64 returns an IBM PASE for i memory address regardless of whether there is currently any memory at that address.

Related Information




API introduced: V5R3

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