.\"
.\"   $Id: msg_open.man,v 1.3 2001/06/14 18:08:34 ura Exp $
.\"
.\"
.\" FreeWnn is a network-extensible Kana-to-Kanji conversion system.
.\" This file is part of FreeWnn.
.\" 
.\" Copyright Kyoto University Research Institute for Mathematical Sciences
.\"                 1987, 1988, 1989, 1990, 1991, 1992
.\" Copyright OMRON Corporation. 1987, 1988, 1989, 1990, 1991, 1992, 1999
.\" Copyright ASTEC, Inc. 1987, 1988, 1989, 1990, 1991, 1992
.\" Copyright FreeWnn Project 1999, 2000
.\" 
.\" Maintainer:  FreeWnn Project   <freewnn@tomo.gr.jp>
.\" 
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\" 
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\" 
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
.\"
.TH MSG_OPEN 3  "7 October 1992"
.SH 名称
.sv 1
.nf
.ta 0.1i 2i
msg_open()	メッセージファイルをオープンする。
.fi
.SH 形式
.sv 1
.nf
.ta 0.1i 3i
#include "msg.h"

struct msg_cd *
msg_open( name, nlspath, lang )
char *name;			/* ファイル名 */
char *nlspath;			/* パス記述 */
char *lang;			/* 言語名 */
.fi
.SH 機能
.HP 0
.IP
メッセージファイル名 name、パス記述 nlspath、および言語名 lang から、
ファイルパスを組み立て、そのファイルを読み込む。ファイルの内容はメッ
セージ毎に struct msg_cat につなげられる。

ファイルパスの記述中には、"%N", "%L" を指定でき、パス名を組み立てる
時にそれぞれ、パラメータで与えられたファイル名 name、言語名 lang に
置き換えられる。

name の先頭が '/' の場合は、絶対パスと見なされ、nlspathは展開されず
name がそのままファイルパスとなる。

lang に NULL や空文字列が渡された場合には、環境変数 LC_MESSAGES、
LANG が順に調べらそこから言語名が取り出される。環境変数からも取り出
せなかった場合には、DEF_LANG が用いられる。
.SH リターンバリュー
.sv 1
.nf
メッセージの内容が展開されてつながれている構造体 msg_cat へのポイン
ターが返される。メッセージファイルがオープンできない場合には、空の構
造体が返される。name の先頭が '/'でない、かつ、nlspathが NULL か
空文字列の場合は、NULLが返される。"%N", "%L" が展開できない場合や、
メモリ領域が確保できない場合も、NULL が返される。
.fi