Linux程序员手册 第3部分
更新日期： 2019-03-06

名称

catgets-从消息目录获取消息

语法

#include <nl_types.h>

char *catgets(nl_catd catalog, int set_number, int message_number,
              const char *message);

说明

catgets()从目录标识的消息目录中读取set_number中的消息message_number，其中catalog是从对catopen(3)的较早调用返回的目录描述符。第四个参数message指向默认的消息字符串，如果标识的消息目录当前不可用，则由catgets()返回。消息文本包含在内部缓冲区中，如果要保存或修改，则应由应用程序复制。返回字符串始终以空字节(aq \ 0aq)终止。

返回值

成功后，catgets()返回一个指向内部缓冲区的指针，该缓冲区包含以空字符结尾的消息字符串。失败时，catgets()返回值消息。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

POSIX.1-2001，POSIX.1-2008。

备注

catgets()函数仅在libc.so.4.4.4c及更高版本中可用。 1987年1月的X / Open可移植性指南指定了更微妙的错误返回：如果目录指定的消息目录不可用，则返回消息，而消息目录可用但不包含指定消息时，返回空字符串。这两个可能的错误返回似乎在SUSv2中被丢弃，而总是返回消息。

另外参见

catopen(3)，setlocale(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。