.\" 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 "msymbol_get" 3m17n "14 Jul 2007" "" "Version 1.4.0" "" "The m17n Library" \" -*- nroff -*- .ad l .nh .SH NAME msymbol_get - Get the value of a symbol property. .SH SYNOPSIS void* \fBmsymbol_get\fP (\fBMSymbol\fP \fIsymbol\fP, \fBMSymbol\fP \fIkey\fP) .SH DESCRIPTION The .ft B msymbol_get() .ft R function searches for the value of the symbol property that belongs to .ft B symbol .ft R and whose key is .ft B key\fP. .ft R If .ft B symbol .ft R has such a symbol property, its value is returned. Otherwise .ft C NULL .ft R is returned. .PP .SH RETURN VALUE .PP.RS 4 If an error is detected, .ft B msymbol_get() .ft R returns .ft C NULL .ft R and assigns an error code to the external variable .ft B merror_code\fP. .ft R .RE .PP .SH ERRORS .PP.RS 4 \fCMERROR_SYMBOL .ft R .RE .PP .SH "SEE ALSO" .PP.RS 4 \fBmsymbol_put() .ft R .RE .PP