Advantage Client Engine
Sets the given field to its NULL value when using ADTs or to its empty value when using DBFs.
UNSIGNED32 |
AdsSetEmpty (ADSHANDLE hObj, UNSIGNED8 *pucFldName); |
hObj (I) |
Handle of table, cursor, or index order. |
pucFldName (I) |
Name of field to set to empty/null. |
Null and empty values vary by field type. AdsSetEmpty ensures that the value set in the field is what Advantage expects as a NULL value for ADTs or an empty value for DBFs.
If the handle passed is an index order handle, the logical record buffer of the index order is modified instead of the table data. The logical record buffer of the index order can be used to build a raw index key in conjunction with calls to AdsInitRawKey and AdsBuildRawKey.
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.