XpGetAttributes(3Xp)

💖 NAME 💖

XpGetAttributes — gets an attribute pool from the specified print context. This one is from the XPRINT FUNCTIONS chapter, page 3Xp, and it's basically here to hand you the whole attribute-pool vibe ✨

---

🦋 SYNOPSIS 🦋

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

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

---

🎀 ARGUMENTS 🎀

• display — a pointer to the Display structure, bestie; you get it back from XOpenDisplay.
• context — the print context you're pulling the attribute pool out of.
• type — specifies which attribute pool you want.

---

🌸 DESCRIPTION 🌸

XpGetAttributes returns a pool, which is a COMPOUND_TEXT resource string representing the attribute pool specified by type. The caller is expected to free pool when it's no longer needed, using XFree. Don't leave your girl hanging, okay? 💅

The attribute pool — and therefore the resource string — consists of many name-value pairs (for example, "copy-count: 3"). The syntax of an attribute pool is the same as an X resource file (see "Resource File Syntax" in the Xlib specification).

Valid characters for each name (the left hand side) are derived from the Posix which is "a"-"z" and "A"="Z" and "0"-"9" and "_" and "-". Yes, the page really has that "A"="Z" moment — I'm copying it exactly, no cap 💀

Valid characters for each value (the right hand side) are all characters except NULL and unescaped NEWLINE, though all predefined values in the X Print Service are confined to X Portable Character Set (XPCS) characters. Non-XPCS values are typically limited to localized "description" strings. See XpCreateContext regarding the locale hint for more information on localized values.

If any errors occur, XpGetAttributes returns NULL.

---

🧚 STRUCTURES 🧚

The values for the typedef XPAttributes in <X11/extensions/Print.h> are:

#define  XPJobAttr       1 /∗ get/set */
#define  XPDocAttr       2 /∗ get/set */
#define  XPPageAttr 3 /∗ get/set-subset of XPDocAttr */
#define  XPPrinterAttr   4 /∗ get only (library) */
#define  XPServerAttr    5 /∗ get only (library), no context needed */

---

🔥 DIAGNOSTICS 🔥

• BadAlloc — insufficient memory 😭
• BadValue — the value specified for type is not valid
• XPBadContext — the specified print context-id is not valid

---

🍓 FILES 🍓

• <X11/extensions/Print.h>

---

👑 SEE ALSO 👑

• XpCreateContext(3Xp)

---

okay that's the whole page, bestie — X Version 11, libXp 1.0.4, and the footer didn't give me a date to quote, so I'm not inventing one 🎀💖