Advantage Client Engine
Determines if a given field is empty (null).
UNSIGNED32 |
AdsIsEmpty (ADSHANDLE hTable, UNSIGNED8 *pucFldName, UNSIGNED16 *pbEmpty); |
hTable (I) |
Handle of table or cursor. |
pucFldName (I) |
Name of field to query. |
pbEmpty (O) |
Will be True on return if the specified field is empty/null. |
Use AdsIsEmpty to determine if the indicated field is NULL for ADTs or empty for DBFs. The NULL/empty value can vary between data types. Therefore, AdsIsEmpty can be used to be certain whether the current field value is NULL/empty.
The pucFldName parameter can be passed as the field name itself or as the one-based integer field position. To pass an integer field position for the pucFldName parameter, use the ADSFIELD macro that is defined in ACE.H. For example, to specify the first field in the table, pass ADSFIELD(1) for the pucFldName parameter; to specify the second field in the table, pass ADSFIELD(2) for the pucFldName parameter; etc.