obj_get function <BLOC/object.h>

The obj_get function obtains a reference to a specified object. It should be used whenever an object is assigned to a variable, except when the object has just been created (i.e. returned from obj_new).

Syntax

void *
obj_get(
	void *addr
);

Parameters

The address of the object to obtain a reference to. This must be a pointer to an object created by the library or the call will cause the program to terminate.

Return value

A pointer to the object, which will match the addr parameter, will be returned.