XtGetErrorB(3x) — HP-UX 9.10

NAME

XtGetErrorDatabaseText − get the text of a named message from the error database.

Synopsis

void XtGetErrorDatabaseText(name, type, class, default, buffer_return, nbytes)

    String name, type, class;
    String default;
    String buffer_return;
    int nbytes;

Inputs

nameSpecifies the name or general kind of the message.

typeSpecifies the type or detailed name of the message.

classSpecifies the resource class of the error message.

defaultSpecifies the default message to use if an error database entry is not found.

nbytesSpecifies the size of buffer_return in bytes.

Outputs

buffer_return
Specifies the buffer into which the error message is to be returned.

Availability

XtGetErrorDatabaseText() has been superseded by XtAppGetErrorDatabaseText().

Description

XtGetErrorDatabaseText() looks up the message named by name, type, and class in the database returned by XtGetErrorDatabase(). If such a message is found, it is stored into buffer_return, otherwise the message in default is stored into buffer_return. The resource name of the message is formed by concatenating name and type with a single "." between them. The resource class of the message is class if it already contains a ".", or otherwise is formed by concatenating class with itself with a single "." between the strings.

Usage

XtGetErrorDatabaseText() has been superseded by XtAppGetErrorDatabaseText(), which performs the same function on a per-application context basis. XtGetErrorDatabaseText() now calls XtAppGetErrorDatabaseText() passing the default application context created by XtInitialize(). Very few programs need multiple application contexts, and you can continue to use XtGetErrorDatabaseText() if you initialize your application with XtInitialize(). We recommend, however, that you use XtAppInitialize(), XtAppGetErrorDatabaseText(), and the other XtApp*() application context specific functions. See XtAppGetErrorDatabaseText() for more information.

Museum

Related Articles