catgets 子例程

在线编辑

用途

从目录检索消息。

库

标准 C 库 (libc.a)

语法

#include <nl_types>

char *catgets (CatalogDescriptor, SetNumber, MessageNumber, String)
nl_catd  CatalogDescriptor;
int  SetNumber,  MessageNumber;
const char * String;

描述

在成功调用 catopen 子例程之后， catgets 子例程从目录检索消息。 如果 catgets 子例程找到指定的消息，它将它装入内部字符串缓冲区，以空字符结束消息字符串，并返回指向缓冲区的指针。

catgets 子例程使用返回的指针来引用缓冲区并显示消息。 但是，在目录关闭后无法引用缓冲区。

参数

项 描述
CatalogDescriptor 指定由 catopen 子例程返回的目录描述。
SetNumber 指定集合标识。
MessageNumber 指定消息标识。 SetNumber 和 MessageNumber 参数指定要在目录中检索的特定消息。
String 指定缺省字符串缓冲区。

返回值

如果 catgets 子例程由于任何原因不成功，那么它将返回由 String 参数指定的用户提供的缺省消息字符串。