.TH ppd_find_choice 3
.SH NAME
ppd_find_choice, ppd_find_marked_choice, ppd_find_option_by_keyword \- set of functions for
returning pointers to choices from PPD files.
.SH SYNOPSIS
.B #include <ppd.h>
.sp
.B PpdChoice *ppd_find_choice (PpdOption *o, const char *choice);
.sp
.B PpdChoice *ppd_find_marked_choice (PpdFile *ppd, const char *keyword);
.sp
.B PpdOption *ppd_find_option_by_keyword (PpdFile *ppd, const char *keyword);
.sp
.SH "DESCRIPTION"
These three functions allow the programmer access options and choices
within a PPD file.
.SS 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.
.sp
.SS PpdChoice *ppd_find_marked_choice (PpdFile *ppd, const char *keyword);
This function accepts a valid PpdFile pointer (see \fBppd_file_new(3)\fP) 
and a keyword or option name to locate in the PPD file.
.sp
.SS 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.
.sp
.SH "RETURN VALUE"
.TP
ppd_find_choice()
Return a pointer to an option choice; NULL in the case of a failure
.TP
ppd_find_marked_choice()
Return the marked choice for the specified option; NULL in the case of a failure
.TP
ppd_find_option_by_keyword()
Return a pointer to the specified option; NULL in the case of a failure
.sp
.SH "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)
.sp
.SH 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).