.\" Copyright (C) 2001 Information-technology Promotion Agency (IPA)
.\" Copyright (C) 2001-2003
.\"   National Institute of Advanced Industrial Science and Technology (AIST)
.\" This file si aprt of the m17n library documentation.
.\" Permission is granted to copy, distribute and/or modify this document
.\" under the terms of the GNU Free Documentation License, Version 1.2 or
.\" any later version published by the Free Software Foundation; with no
.\" Invariant Section, Front-Cover Texts "The m17n library documentation",
.\" and no Back-Cover Texts.  A copy of the license is included in the
.\" appendix entitled "GNU Free Documentation License".
.TH "Managed Object" 3m17n "14 Jul 2007" "" "Version 1.4.0" "" "The m17n Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
Managed Object \- Managed objects are objects managed by the reference count.  

.PP
.SS "Data Structures"

.in +1c
.ti -1c
.RI "struct \fBM17NObjectHead\fP"
.br
.RI "\fIThe first member of a managed object. \fP"
.in -1c
.SS "Functions"

.in +1c
.ti -1c
.RI "void * \fBm17n_object\fP (int size, void(*freer)(void *))"
.br
.RI "\fIAllocate a managed object. \fP"
.ti -1c
.RI "int \fBm17n_object_ref\fP (void *object)"
.br
.RI "\fIIncrement the reference count of a managed object. \fP"
.ti -1c
.RI "int \fBm17n_object_unref\fP (void *object)"
.br
.RI "\fIDecrement the reference count of a managed object. \fP"
.in -1c
.SH "Detailed Description"
.PP 
There are some types of m17n objects that are managed by their reference count. Those objects are called \fImanaged\fP \fIobjects\fP. When created, the reference count of a managed object is initialized to one. The \fBm17n_object_ref()\fP function increments the reference count of a managed object by one, and the \fBm17n_object_unref()\fP function decrements by one. A managed object is automatically freed when its reference count becomes zero.
.PP
A property whose key is a managing key can have only a managed object as its value. Some functions, for instance \fBmsymbol_put()\fP and \fBmplist_put()\fP, pay special attention to such a property.
.PP
In addition to the predefined managed object types, users can define their own managed object types. See the documentation of the \fBm17n_object()\fP for more details. 
.SH "Data Structure Documentation"
.SS M17NObjectHead
.PP
The first member of a managed object.  

.PP
.ad l
.nh
.PP
\fBFIELD DOCUMENTATION:\fP
.PP 
.PP
\fBvoid* \fBM17NObjectHead::filler\fP[2]\fP
.PP