.\" Copyright (C) 2001 Information-technology Promotion Agency (IPA) .\" Copyright (C) 2001-2011 .\" National Institute of Advanced Industrial Science and Technology (AIST) .\" This file is part 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, no Front-Cover Texts, .\" and no Back-Cover Texts. A copy of the license is included in the .\" appendix entitled "GNU Free Documentation License". .TH "mlocale_set" 3m17n "Mon Sep 25 2023" "Version 1.8.4" "The m17n Library" \" -*- nroff -*- .ad l .nh .SH NAME mlocale_set \- .SH SYNOPSIS \fBMLocale\fP* \fBmlocale_set\fP (int \fIcategory\fP, const char * \fIname\fP) .SH DESCRIPTION .PP Set the current locale\&. The .ft B mlocale_set() .ft R function sets or query a part of the current locale\&. The part is specified by .ft B category .ft R which must be a valid first argument to .ft C setlocale()\fP\&. .PP If .ft B locale .ft R is not NULL, the locale of the specified part is set to .ft B locale\fP\&. If .ft B locale .ft R is not supported by the system, the current locale is not changed\&. .PP If .ft B locale .ft R is NULL, the current locale of the specified part is queried\&. .PP .SH RETURN VALUE .PP .RS 4 If the call is successful, .ft B mlocale_set() .ft R returns an opaque locale object that corresponds to the locale\&. The name of the locale can be acquired by the function .ft B mlocale_get_prop()\fP\&. Otherwise, it returns NULL\&. .br .RE .PP .SH ERRORS .PP .RS 4 \fCMERROR_LOCALE .ft R .br .RE .PP .SH COPYRIGHT Copyright (C) 2001 Information\-technology Promotion Agency (IPA) .br Copyright (C) 2001\-2011 National Institute of Advanced Industrial Science and Technology (AIST) .br Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License .