XpGetOneAttribute(3)

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)

X Version 11                      libXp 1.0.0           XpGetOneAttribute(3Xp)