ppd_find_choice(3) ppd_find_choice(3) NAME ppd_find_choice, ppd_find_marked_choice, ppd_find_option_by_keyword - set of functions for return- ing pointers to choices from PPD files. SYNOPSIS #include 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); DESCRIPTION These three functions allow the programmer access options and choices within a PPD file. PpdChoice *ppd_find_choice (PpdOption *o, const char *choice); This function accepts two parameters. The first is a pointer to a PPD option structure and the second is the name of the choice to locate. PpdChoice *ppd_find_marked_choice (PpdFile *ppd, const char *keyword); This function accepts a valid PpdFile pointer (see ppd_file_new(3)) and a keyword or option name to locate in the PPD file. PpdOption *ppd_find_option_by_keyword (PpdFile *ppd, const char *keyword); This function accepts two parameters which are identical to those used when invoking the ppd_find_marked_choice() function. However, the ppd_find_option_by_keyword() func- tion does not mark the designated option as being selected. RETURN VALUE ppd_find_choice() Return a pointer to an option choice; NULL in the case of a failure ppd_find_marked_choice() Return the marked choice for the specified option; NULL in the case of a failure ppd_find_option_by_keyword() Return a pointer to the specified option; NULL in the case of a failure SEE ALSO 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 . It was updated by Mark Fasheh to reflect changes in libppd 0.5 Some of the code for these functions was originally part of the Common UNIX Printing System (CUPS). 1