DOKK / manpages / debian 11 / m17n-docs / m17n_object_unref.3m17n.en
m17n_object_unref(3m17n) The m17n Library m17n_object_unref(3m17n)

m17n_object_unref - Decrement the reference count of a managed object.

int m17n_object_unref (void * object)

Decrement the reference count of a managed object. The m17n_object_unref() function decrements the reference count of the managed object pointed to by object. When the reference count becomes zero, the object is freed by its freer function.

This function returns the resulting reference count if it fits in a 16-bit unsigned integer (i.e. less than 0x10000). Otherwise, it returns -1. Thus, the return value zero means that object is freed.

This function never fails.

Copyright (C) 2001 Information-technology Promotion Agency (IPA)
Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License <http://www.gnu.org/licenses/fdl.html>.

12 Jan 2011 Version 1.6.2