xtgeterrordatabase(3xt) [osf1 man page]

XtGetErrorDatabase(3Xt) 												   XtGetErrorDatabase(3Xt)

NAME

       XtGetErrorDatabase, XtGetErrorDatabaseText - obtain error database

SYNOPSIS

       XrmDatabase *XtGetErrorDatabase()

       void XtGetErrorDatabaseText(name, type, class, default, buffer_return, nbytes, database)
	       char *name, *type, *class;
	       char *default;
	       char *buffer_return;
	       int nbytes;
	       XrmDatabase database;

ARGUMENTS

       Specifies  the  buffer  into  which the error message is to be returned.  Specifies the resource class of the error message.  Specifies the
       name of the alternative database that is to be used or NULL if the application's database is to be used.  Specifies the default message	to
       use.   Specifies  the name and type that are concatenated to form the resource name of the error message.  Specifies the size of the buffer
       in bytes.

DESCRIPTION

       The XtGetErrorDatabase function has been superceded by XtAppGetErrorDatabase.

       The XtGetErrorDatabaseText function has been superceded by XtAppGetErrorDatabaseText.

SEE ALSO

       X Toolkit Intrinsics -- C Language Interface

       Xlib -- C Language X Interface

															   XtGetErrorDatabase(3Xt)

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()