PA_GetPointerTableField

version 2003

PA_GetPointerTableField (pointer; table; field)

Parameter	Type		Description
pointer	PA_Pointer	→	The 4D pointer
table	short *	←	Table number of the table pointed to by the pointer
field	short *	←	Field number of the table pointed to by the pointer

Description

The routine PA_GetPointerTableField returns the table and field numbers that pointer references.

Depending on what kind of pointer pointer is, the returned values are:

Pointer kind	* tNum	* fNum
To Field	Table number	Field number
To Table	Table number	0
else	0	0

You can use PA_GetPointerKind to determine what kind of pointer the4Dptr is.

NOTE

4th Dimension pointers are not standard C pointers. They are structures that tell 4D to what kind of data they point: a table, a field, or a variable (process or interprocess).

Since a pointer does not have the same definition and use in interpreted and compiled mode, the developer should use the accessors of this API.

Example

Using the table number from a pointer to a table:

   /* . . . */
   if ( PA_GetPointerKind( a4Dptr ) == ePK_PointerToTable )
   {
      PA_GetPointerTableField(a4Dptr, &table, &field);
      /* . . . */
   }

Error Handling


   
    
     PA_GetLastError

keeps the last error that occurred before calling the routine.