VA FileMan V. 22.0 Programmer Manual Banner


 

Main Chapter Getting Started Manual Advanced User Manual

Database Server (DBS) API


$$VALUE1^DILF( ): FDA Value Retriever (Single)

This extrinsic function returns the value associated with a particular file and field in a standard FDA. Only a single value is returned. If there is more than one node in the FDA array for the same field, the first value encountered by this function is returned. Use the VALUES^DILF call if you want more than one value returned.

Format
$$VALUE1^DILF(FILE,FIELD,FDA_ROOT)
Input Parameters
FILE

(Required) File or subfile number.

FIELD

(Required) Field number for which data is being requested.

FDA_ROOT

(Required) The root of the FDA from which data is being requested.

Output

This function returns the value for the specified file and field that is stored in the FDA identified by FDA_ROOT. If the field is a word processing field, only the root at which word processing data is stored is returned. No IENS information is returned. If more than one value is associated with a particular field (for example, in a subfile), only a single value is returned.

If there is no node in the FDA for a particular field, an '^' is returned. If the node has a null value, null is returned.

Example
    >ZW MYFDA
    MYFDA("DATA",16200,"33,",4)=FREE TEXT DATA
    MYFDA("DATA",16200.04,"1,33,",1)=16
    MYFDA("DATA",16200.04,"2,33,",1)=45
    
    >W $$VALUE1^DILF(16200,4,"MYFDA(""DATA"")")
    FREE TEXT DATA

Error Codes Returned

None

 


Reviewed/Updated: March 10, 2007