next up previous contents
Next: 11.5 fluke_ref_compare: determine if Up: 11 References Previous: 11.3 References

11.4 fluke_ref_check: determine if a reference is non-null

SYNOPSIS

int fluke_ref_check(fluke_ref_t *ref);

DESCRIPTION

This function determines if the given reference object referring to a valid Fluke object or is null.

PARAMETERS

ref
The reference object to check.

RETURNS

Returns zero if the reference is null, non-zero otherwise.

ERRORS

If any of the following errors is detected by the Fluke implementation, it causes the current thread to take a synchronous exception with one of the following codes. All of these have an implicit FLUKE_INSANITY_ prefix.
NO_OBJECT
ref does not point to an active object.
NOT_REF
The object pointed to by ref is not a reference object.
INVALID_OBJECT
The state of the reference object has become invalid.



Utah Flux Research Group