hpux man page for xtgeterrorb

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.

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  mes-
  sage	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  applica-
  tion	with  XtInitialize().	We  recommend,	however,  that you use XtAppInitialize(), XtAppGetErrorDatabaseText(), and the other XtApp*()
  application context specific functions.

  See XtAppGetErrorDatabaseText() for more information.

See Also
  XtAppGetErrorDatabase(1), XtAppGetErrorDatabaseText(1),
  XtErrorMsgHandler(2).

Xt - Error Handling													  XtGetErrorDatabaseText()