obj_put function <BLOC/object.h>

The obj_put function drops a reference to a specified object. It should be used whenever an object is unassigned from a variable. This includes when another object takes its place or when it's being made NULL. This call will drop the reference, but will not reassign the variable to NULL, so care must be taken to deal with the remaining dangling pointer.

Syntax

void
obj_put(
	void *addr
);

Parameters

addr

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