cups/ppd-custom.c

   1 /*
   2  * PPD custom option routines for CUPS.
   3  *
   4  * Copyright 2007-2015 by Apple Inc.
   5  * Copyright 1997-2006 by Easy Software Products, all rights reserved.
   6  *
   7  * Licensed under Apache License v2.0.  See the file "LICENSE" for more
   8  * information.
   9  *
  10  * PostScript is a trademark of Adobe Systems, Inc.
  11  */
  12
  13 /*
  14  * Include necessary headers.
  15  */
  16
  17 #include "cups-private.h"
  18 #include "ppd-private.h"
  19
  20
  21 /*
  22  * 'ppdFindCustomOption()' - Find a custom option.
  23  *
  24  * @since CUPS 1.2/macOS 10.5@
  25  */
  26
  27 ppd_coption_t *                         /* O - Custom option or NULL */
  28 ppdFindCustomOption(ppd_file_t *ppd,    /* I - PPD file */
  29                     const char *keyword)/* I - Custom option name */
  30 {
  31   ppd_coption_t key;                    /* Custom option search key */
  32
  33
  34   if (!ppd)
  35     return (NULL);
  36
  37   strlcpy(key.keyword, keyword, sizeof(key.keyword));
  38   return ((ppd_coption_t *)cupsArrayFind(ppd->coptions, &key));
  39 }
  40
  41
  42 /*
  43  * 'ppdFindCustomParam()' - Find a parameter for a custom option.
  44  *
  45  * @since CUPS 1.2/macOS 10.5@
  46  */
  47
  48 ppd_cparam_t *                          /* O - Custom parameter or NULL */
  49 ppdFindCustomParam(ppd_coption_t *opt,  /* I - Custom option */
  50                    const char    *name) /* I - Parameter name */
  51 {
  52   ppd_cparam_t  *param;                 /* Current custom parameter */
  53
  54
  55   if (!opt)
  56     return (NULL);
  57
  58   for (param = (ppd_cparam_t *)cupsArrayFirst(opt->params);
  59        param;
  60        param = (ppd_cparam_t *)cupsArrayNext(opt->params))
  61     if (!_cups_strcasecmp(param->name, name))
  62       break;
  63
  64   return (param);
  65 }
  66
  67
  68 /*
  69  * 'ppdFirstCustomParam()' - Return the first parameter for a custom option.
  70  *
  71  * @since CUPS 1.2/macOS 10.5@
  72  */
  73
  74 ppd_cparam_t *                          /* O - Custom parameter or NULL */
  75 ppdFirstCustomParam(ppd_coption_t *opt) /* I - Custom option */
  76 {
  77   if (!opt)
  78     return (NULL);
  79
  80   return ((ppd_cparam_t *)cupsArrayFirst(opt->params));
  81 }
  82
  83
  84 /*
  85  * 'ppdNextCustomParam()' - Return the next parameter for a custom option.
  86  *
  87  * @since CUPS 1.2/macOS 10.5@
  88  */
  89
  90 ppd_cparam_t *                          /* O - Custom parameter or NULL */
  91 ppdNextCustomParam(ppd_coption_t *opt)  /* I - Custom option */
  92 {
  93   if (!opt)
  94     return (NULL);
  95
  96   return ((ppd_cparam_t *)cupsArrayNext(opt->params));
  97 }