xHarbour Reference Documentation > Function Reference

UsrRdd_AreaData()

Queries or attaches user-defined data to a work area of a user-defined RDD.

Syntax

UsrRdd_AreaData( <nWA>|<pWA>, [<xNewData>] ) --> xOldData

Arguments

<nWA>

This is the numeric work area identifier of a work area maintained by a user-defined RDD.

<pWA>

Alternatively, the work area pointer as passed from internal functions of the RDD system can be specified.

<xNewData>

This is the data to attach to a work area maintained by a user-defined RDD.

Return

The function returns the previous data attached to the work area.

Description

Function UsrRdd_AreaData() is used to attach user-defined data to the work area maintained by a user-defined RDD. Such data is usually an array or an object holding state variables of a work area. The function is normally called in response to the USE command, when a table is opened in a work area. User-defined data is discarded automatically when the work area is closed.

Refer to the PRG files in \source\rdd\usrrdd\rdds for examples of attaching user-defined data to a work area.

Info

See also:	UsrRdd_RddData(), UsrRdd_AreaResult(), Select()
Category:	Database drivers , User-defined RDD , xHarbour extensions
Header:	usrrdd.ch
Source:	rdd\usrrdd\usrrdd.c
LIB:	lib\xhb.lib
DLL:	dll\xhbdll.dll