NAME

       ppd_find_choice, ppd_find_marked_choice, ppd_find_option_by_keyword - set of functions for
       returning pointers to choices from PPD files.

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);

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() function
       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 <gcarter@valinux.com>.  It was updated by Mark
       Fasheh <mfasheh@valinux.com> to reflect changes in libppd 0.5 Some of the code  for  these
       functions was originally part of the Common UNIX Printing System (CUPS).

                                                                               ppd_find_choice(3)