📄 catopen.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><!-- Copyright 1997 The Open Group, All Rights Reserved --><title>catopen</title></head><body bgcolor=white><center><font size=2>The Single UNIX ® Specification, Version 2<br>Copyright © 1997 The Open Group</font></center><hr size=2 noshade><h4><a name = "tag_000_001_368"> </a>NAME</h4><blockquote>catopen - open a message catalogue</blockquote><h4><a name = "tag_000_001_369"> </a>SYNOPSIS</h4><blockquote><pre><code>#include <<a href="nl_types.h.html">nl_types.h</a>>nl_catd catopen(const char *<i>name</i>, int <i>oflag</i>);</code></pre></blockquote><h4><a name = "tag_000_001_370"> </a>DESCRIPTION</h4><blockquote>The<i>catopen()</i>function opens a message catalogue and returns a message catalogue descriptor.The<i>name</i>argument specifies the name of the message catalogue to be opened.If<i>name</i>contains a "/", then<i>name</i>specifies a complete name for the message catalogue.Otherwise, the environment variable<i>NLSPATH</i>is used with<i>name</i>substituted for<i>%N</i>(see the <b>XBD</b> specification, <a href="../xbd/envvar.html"><b>Environment Variables</b> </a>).If<i>NLSPATH</i>does not exist in the environment,or if a message catalogue cannot be foundin any of the components specified by<i>NLSPATH</i>,then an implementation-dependent default path is used.This default may be affected by the setting of LC_MESSAGESif the value of<i>oflag</i>is NL_CAT_LOCALE, or the<i>LANG</i>environment variable if<i>oflag</i>is 0.<p>A message catalogue descriptor remains valid in a process untilthat process closes it,or a successful call to one of the<i>exec</i>functions.A change in the setting of the LC_MESSAGES category may invalidateexisting open catalogues.<p>If a file descriptor is used to implement message catalogue descriptors,the FD_CLOEXEC flag will be set; see<i><a href="fcntl.h.html"><fcntl.h></a></i>.<p>If the value of the<i>oflag</i>argument is 0, the<i>LANG</i>environment variable is used to locate the catalogue without regard to theLC_MESSAGES category. If the<i>oflag</i>argument is NL_CAT_LOCALE, the LC_MESSAGES category is used to locate themessage catalogue (see the <b>XBD</b> specification, <a href="../xbd/envvar.html#tag_002_002"><b>Environment Variables</b> </a>).</blockquote><h4><a name = "tag_000_001_371"> </a>RETURN VALUE</h4><blockquote>Upon successful completion,<i>catopen()</i>returns a message catalogue descriptor for use onsubsequent calls to<i><a href="catgets.html">catgets()</a></i>and<i><a href="catclose.html">catclose()</a></i>.Otherwise<i>catopen()</i>returns (<b>nl_catd</b> )-1 and sets<i>errno</i>to indicate the error.</blockquote><h4><a name = "tag_000_001_372"> </a>ERRORS</h4><blockquote>The<i>catopen()</i>function may fail if:<dl compact><dt>[EACCES]<dd>Search permission is denied for the component of the path prefix ofthe message catalogue or read permission is denied forthe message catalogue.<dt>[EMFILE]<dd>{OPEN_MAX} file descriptors are currently open in the calling process.<dt>[ENAMETOOLONG]<dd>The length of the pathname of the message catalogue exceeds {PATH_MAX},or a pathname component is longer than {NAME_MAX}.<dt>[ENAMETOOLONG]<dd><br>Pathname resolution of a symbolic link produced an intermediate result whoselength exceeds {PATH_MAX}.<dt>[ENFILE]<dd>Too many files are currently open in the system.<dt>[ENOENT]<dd>The message catalogue does not exist or the<i>name</i>argument points to an empty string.<dt>[ENOMEM]<dd>Insufficient storage space is available.<dt>[ENOTDIR]<dd>A component of the path prefix of the message catalogue is not a directory.</dl></blockquote><h4><a name = "tag_000_001_373"> </a>EXAMPLES</h4><blockquote>None.</blockquote><h4><a name = "tag_000_001_374"> </a>APPLICATION USAGE</h4><blockquote>Some implementations of<i>catopen()</i>use<i><a href="malloc.html">malloc()</a></i>to allocate space for internal buffer areas.The<i>catopen()</i>function may fail if there is insufficient storage space availableto accommodate these buffers.<p>Portable applications must assume that message cataloguedescriptors are not valid after a call to one of the<i>exec</i>functions.<p>Application writers should be aware that guidelines for the location ofmessage catalogues have not yet been developed. Therefore they should takecare to avoid conflicting with catalogues used by other applications and thestandard utilities.</blockquote><h4><a name = "tag_000_001_375"> </a>FUTURE DIRECTIONS</h4><blockquote>None.</blockquote><h4><a name = "tag_000_001_376"> </a>SEE ALSO</h4><blockquote><i><a href="catclose.html">catclose()</a></i>,<i><a href="catgets.html">catgets()</a></i>,<i><a href="fcntl.h.html"><fcntl.h></a></i>,<i><a href="nl_types.h.html"><nl_types.h></a></i>,the <b>XCU</b> specification,<i><a href="../xcu/gencat.html">gencat</a></i>.</blockquote><hr size=2 noshade><center><font size=2>UNIX ® is a registered Trademark of The Open Group.<br>Copyright © 1997 The Open Group<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]</font></center><hr size=2 noshade></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -