---
name: "m17n_object_unref"
section: "3m17n"
platform: "linux"
package: "m17n-docs"
version: "1.8.4-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/m17n_object_unref"
---

# m17n\_object\_unref(3m17n)

## NAME

m17n\_object\_unref -

## SYNOPSIS

int **m17n\_object\_unref** (void \* *object*)

## DESCRIPTION

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.

## RETURN VALUE

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.

## ERRORS

This function never fails. \

## COPYRIGHT

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\>.