ppd_find_choice(3)

💅 ppd_find_choice — bestie edition

okay so this is a page from the Library Functions Manual, and it's literally all about three lil functions that hand you back pointers to choices from PPD files. no cap. if you're out here digging through PPD files looking for a specific option or choice, these three are your girls. 🎀

---

✨ SYNOPSIS ✨

#include <ppd.h>

PpdChoice *ppd_find_choice (PpdOption *o, const char *choice);

PpdChoice *ppd_find_marked_choice (PpdFile *ppd, const char *keyword);

PpdOption *ppd_find_option_by_keyword (PpdFile *ppd, const char *keyword);

like, include the header first bestie, that's the vibe. 🌸

---

🌈 DESCRIPTION 🌈

so these three functions? they're the whole friend group that lets you, the programmer, get at the options and choices inside a PPD file. it's giving backstage pass energy. 👑

💖 PpdChoice *ppd_find_choice (PpdOption *o, const char *choice);

this one takes two parameters, periodt.

1. a pointer to a PPD option structure — that's the *o
2. the name of the choice you're tryna locate

that's it. that's the function. she's simple, she's iconic. ✨

🦋 PpdChoice *ppd_find_marked_choice (PpdFile *ppd, const char *keyword);

this one wants a valid PpdFile pointer (go look at ppd_file_new(3) if you need one, iykyk) plus a keyword or option name that you're hunting for inside the PPD file. hand her both and she goes looking. 🔍

👑 PpdOption *ppd_find_option_by_keyword (PpdFile *ppd, const char *keyword);

okay so this one takes two parameters that are identical to the ones you'd use when you call ppd_find_marked_choice() — same ppd, same keyword. BUT. and this is the important part bestie, don't skip it:

ppd_find_option_by_keyword() does not mark the designated option as being selected.

so she finds the option, but she does not claim it. she's just looking. no strings attached. 💅

---

🎀 RETURN VALUE 🎀

• ppd_find_choice() — returns a pointer to an option choice, and NULL in the case of a failure 😭
• ppd_find_marked_choice() — returns the marked choice for the specified option, and NULL in the case of a failure 😭
• ppd_find_option_by_keyword() — returns a pointer to the specified option, and NULL in the case of a failure 😭

so yeah, if you get NULL back, something went sideways. check your args, bestie. 🫶

---

🔥 SEE ALSO 🔥

these ones are the mutuals, go say hi:

• ppd_file_new(3)
• ppd_emit_to_file(3)
• ppd_file_free(3)
• ppd_get_num_conflicts(3)
• ppd_check_option_is_marked(3)
• ppd_get_page_length(3)

---

💜 AUTHOR 💜

this man page was written by Gerald Carter <gcarter@valinux.com>. it was then updated by Mark Fasheh <mfasheh@valinux.com> to reflect the changes in libppd 0.5. and plot twist — some of the code for these functions was originally part of the Common UNIX Printing System (CUPS). iconic lineage fr fr. 🌟

---

and that's the whole page, bestie — this was ppd_find_choice(3) from the Library Functions Manual, brought to you by libppd and dated the way the footer says it. mwah, go find your choices. 💋🎀✨