XtGetErrorDatabaseText()XtGetErrorDatabaseText()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
name Specifies the name or general kind of the message.
type Specifies the type or detailed name of the message.
class Specifies the resource class of the error message.
default Specifies the default message to use if an error database
entry is not found.
nbytes Specifies the size of buffer_return in bytes.
Outputs
buffer_return
Specifies the buffer into which the error message is to be
returned.
AvailabilityXtGetErrorDatabaseText() has been superseded by XtAppGetErrorDatabase‐
Text().
DescriptionXtGetErrorDatabaseText() looks up the message named by name, type, and
class in the database returned by XtGetErrorDatabase(). If such a mes‐
sage 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 con‐
catenating class with itself with a single "." between the strings.
UsageXtGetErrorDatabaseText() has been superseded by XtAppGetErrorDatabase‐
Text(), 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 con‐
tinue to use XtGetErrorDatabaseText() if you initialize your applica‐
tion with XtInitialize(). We recommend, however, that you use XtAp‐
pInitialize(), XtAppGetErrorDatabaseText(), and the other XtApp*()
application context specific functions.
See XtAppGetErrorDatabaseText() for more information.
See AlsoXtAppGetErrorDatabase(1), XtAppGetErrorDatabaseText(1),
XtErrorMsgHandler(2).
Xt - Error Handling XtGetErrorDatabaseText()