GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PPD_FIND_CHOICE (3)

NAME

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

CONTENTS

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

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

Search for    or go to Top of page |  Section 3 |  Main Index


PPD_FIND_CHOICE (3) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.