11.3.2 Token Values

	typedef struct TokenValue {
		union {
			char		*string;
			EntryRef		*ref;
			float		number;
		} result;
		char		shouldFree;	
		char		flags;	
		TokAddrRec		*address;		/* For internal use only						 */
		TokInfo		info;	
	} TokenValue;
 

The flags field of a TokenValue identifies the type of value stored in the result union; it will be one of string_tok_info, reference_tok_info, or number_tok_info; the token value will then be found in result.string, result.ref, or result.number, respectively.

If a TokenValue array is obtained from GetToks(), the values are guaranteed to be strings. Similarly, GetRefs() guarantees references. Some other functions may return mixed types.

TokenValue routines should be used to read multiple tokens from an entry. This is more efficient than looping with GetATok(), and may also yeild different results if the tokens are derived from a side-effect expression.