XpGetOneAttribute

XpGetOneAttribute(3Xp)	       XPRINT FUNCTIONS	       XpGetOneAttribute(3Xp)



NAME
       XpGetOneAttribute  -  Gets a single print attribute from the specified
       print context.

SYNOPSIS
	     cc [ flag... ] file... -lXp [ library... ]
	     #include <X11/extensions/Print.h>

       char *XpGetOneAttribute ( display, context, type, attribute_name )
	     Display *display;
	     XPContext context;
	     XPAttributes type;
	     char *attribute_name;

ARGUMENTS
       display
	      Specifies a pointer to the  Display  structure;  returned	 from
	      XOpenDisplay.

       context
	      The  print  context  from	 which	the  attribute	pool is to be
	      retrieved.

       type   Specifies the attribute pool.

       attribute_name
	      The name of the attribute to be returned.

DESCRIPTION
       This request returns a COMPOUND_TEXT string attribute_value, else NULL
       if  any errors occurred.	 XpGetOneAttribute is a variation of XpGetAt-
       tributes to get a single	 attribute  value  from	 an  attribute	pool.
       Unlike  XpGetAttributes,	 where the reply contains an entire attribute
       pool,   XpGetOneAttribute   returns    just    one    attribute_value.
       attribute_name  should  not include a colon. The caller is expected to
       free the attribute value returned using XFree.

DIAGNOSTICS
       BadAlloc	      Insufficient memory.

       BadValue	      The value specified for type is not valid.

       XPBadContext   The specified print context-id is not valid.

SEE ALSO
       XpGetAttributes(3Xp)




						       XpGetOneAttribute(3Xp)