next up previous contents
Next: 11.7 fluke_ref_create: create a Up: 11 References Previous: 11.5 fluke_ref_compare: determine if

11.6 fluke_ref_copy: make a copy of a reference object

SYNOPSIS

void fluke_ref_copy(fluke_ref_t *src_ref, fluke_ref_t *dst_ref);

DESCRIPTION

Makes the reference object at dst_ref reference the same thing as src_ref. Any former association for the destination is severed.

PARAMETERS

src_ref
The address of the reference object to copy.
dst_ref
The valid reference object which becomes the copy.

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
src_ref or dst_ref does not point to an active object.
NOT_REF
The object pointed to by src_ref or dst_ref is not a reference object.
INVALID_OBJECT
The state of src_ref or dst_ref has become invalid.



Utah Flux Research Group