.\" 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 "mlanguage_name_list" 3m17n "Mon Sep 25 2023" "Version 1.8.4" "The m17n Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
mlanguage_name_list \- 


.SH SYNOPSIS
\fBMPlist\fP*
\fBmlanguage_name_list\fP (MSymbol
\fIlanguage\fP, MSymbol
\fItarget\fP, MSymbol
\fIscript\fP, MSymbol
\fIterritory\fP)


.SH DESCRIPTION
.PP
Return the language names written in the specified language\&. The
.ft B
mlanguage_name_list()
.ft R
function returns a plist of LANGUAGE's names written in TARGET language\&. SCRIPT and TERRITORY, if not
.ft B
Mnil\fP,
.ft R
specifies which script and territory to concern at first\&.
.PP
LANGUAGE and TARGET must be a symbol whose name is an ISO639\-2 3\-letter language code or an ISO639\-1 2\-letter language codes\&. TARGET may be
.ft B
Mnil\fP,
.ft R
in which case, the language of the current locale is used\&. If locale is not set or is C, English is used\&.
.PP
SCRIPT and TERRITORY must be a symbol whose name is a script and territory name of a locale (e\&.g\&. 'TW', 'SG') respectively\&.
.PP
.SH RETURN VALUE
.PP
.RS 4
If the translation is available, this function returns a non\-empty plist\&. The first element has key
.ft B
MText
.ft R
and the value is an M\-text of a translated language name\&. If the succeeding elements also have key
.ft B
MText\fP,
.ft R
their values are M\-texts of alternate translations\&.
.RE
.PP
If no translation is available,
.ft C
NULL
.ft R
is returned\&.
.PP
The returned plist should not be modified nor freed\&.
.PP
.SH "SEE ALSO"
.PP
.RS 4
\fBmlanguage_code()\fP,
.ft R
.ft B
mlanguage_text()\fP\&. 
.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 
<http://www.gnu.org/licenses/fdl.html>.