#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: cups 1.4b2\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2009-01-10 21:21-0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: Translate Toolkit 1.2.1\n"

#: ./api-array.html:1
msgid "Array API"
msgstr ""

#: ./api-array.html:2
msgid "Programming"
msgstr ""

#: ./api-array.html:3
msgid "Mini-XML v2.6"
msgstr ""

#: ./api-array.html:4
msgid "General Information"
msgstr ""

#: ./api-array.html:5
msgid "Header"
msgstr ""

#: ./api-array.html:6
msgid "cups/array.h"
msgstr ""

#: ./api-array.html:7
msgid "Library"
msgstr ""

#: ./api-array.html:8
msgid "-lcups"
msgstr ""

#: ./api-array.html:9
msgid "See Also"
msgstr ""

#: ./api-array.html:10
msgid ""
"Programming: <a href='api-overview.html' target='_top'>Introduction to CUPS "
"Programming</a>"
msgstr ""

#: ./api-array.html:11
msgid "Contents"
msgstr ""

#: ./api-array.html:12
msgctxt "./api-array.html:12"
msgid "Overview"
msgstr ""

#: ./api-array.html:13
msgctxt "./api-array.html:13"
msgid "Managing Arrays"
msgstr ""

#: ./api-array.html:14
msgctxt "./api-array.html:14"
msgid "Finding and Enumerating Elements"
msgstr ""

#: ./api-array.html:15
msgctxt "./api-array.html:15"
msgid "Functions"
msgstr ""

#: ./api-array.html:16
msgid "cupsArrayAdd"
msgstr ""

#: ./api-array.html:17
msgid "cupsArrayClear"
msgstr ""

#: ./api-array.html:18
msgid "cupsArrayCount"
msgstr ""

#: ./api-array.html:19
msgid "cupsArrayCurrent"
msgstr ""

#: ./api-array.html:20
msgid "cupsArrayDelete"
msgstr ""

#: ./api-array.html:21
msgid "cupsArrayDup"
msgstr ""

#: ./api-array.html:22
msgctxt "./api-array.html:22"
msgid "cupsArrayFind"
msgstr ""

#: ./api-array.html:23
msgctxt "./api-array.html:23"
msgid "cupsArrayFirst"
msgstr ""

#: ./api-array.html:24
msgid "cupsArrayGetIndex"
msgstr ""

#: ./api-array.html:25
msgid "cupsArrayGetInsert"
msgstr ""

#: ./api-array.html:26
msgctxt "./api-array.html:26"
msgid "cupsArrayIndex"
msgstr ""

#: ./api-array.html:27
msgid "cupsArrayInsert"
msgstr ""

#: ./api-array.html:28
msgctxt "./api-array.html:28"
msgid "cupsArrayLast"
msgstr ""

#: ./api-array.html:29
msgid "cupsArrayNew"
msgstr ""

#: ./api-array.html:30
msgid "cupsArrayNew2"
msgstr ""

#: ./api-array.html:31
msgctxt "./api-array.html:31"
msgid "cupsArrayNext"
msgstr ""

#: ./api-array.html:32
msgctxt "./api-array.html:32"
msgid "cupsArrayPrev"
msgstr ""

#: ./api-array.html:33
msgid "cupsArrayRemove"
msgstr ""

#: ./api-array.html:34
msgid "<code>cupsArraySave</code></a>.\">cupsArrayRestore"
msgstr ""

#: ./api-array.html:35
msgid "<code>cupsArrayRestore</code></a>.\">cupsArraySave"
msgstr ""

#: ./api-array.html:36
msgid "cupsArrayUserData"
msgstr ""

#: ./api-array.html:37
msgctxt "./api-array.html:37"
msgid "Data Types"
msgstr ""

#: ./api-array.html:38
msgctxt "./api-array.html:38"
msgid "cups_ahash_func_t"
msgstr ""

#: ./api-array.html:39
msgctxt "./api-array.html:39"
msgid "cups_array_func_t"
msgstr ""

#: ./api-array.html:40
msgctxt "./api-array.html:40"
msgid "cups_array_t"
msgstr ""

#: ./api-array.html:41
msgctxt "./api-array.html:41"
msgid "Overview"
msgstr ""

#: ./api-array.html:42
msgid ""
"The CUPS array API provides a high-performance generic array container. The "
"contents of the array container can be sorted and the container itself is "
"designed for optimal speed and memory usage under a wide variety of "
"conditions. Sorted arrays use a binary search algorithm from the last found "
"or inserted element to quickly find matching elements in the array. Arrays "
"created with the optional hash function can often find elements with a "
"single lookup. The <a href='#cups_array_t'><code>cups_array_t</code></a> "
"type is used when referring to a CUPS array."
msgstr ""

#: ./api-array.html:43
msgid ""
"The CUPS scheduler (<tt>cupsd</tt>) and many of the CUPS API functions use "
"the array API to efficiently manage large lists of data."
msgstr ""

#: ./api-array.html:44
msgctxt "./api-array.html:44"
msgid "Managing Arrays"
msgstr ""

#: ./api-array.html:45
msgid ""
"Arrays are created using either the <a "
"href='#cupsArrayNew'><code>cupsArrayNew</code></a> or <a "
"href='#cupsArrayNew2'><code>cupsArrayNew2</code></a> functions. The first "
"function creates a new array with the specified callback function and user "
"data pointer:"
msgstr ""

#: ./api-array.html:46
msgid ""
"The comparison function (type <a "
"href=\"#cups_arrayfunc_t\"><code>cups_arrayfunc_t</code></a>) is called "
"whenever an element is added to the array and can be <code>NULL</code> to "
"create an unsorted array. The function returns -1 if the first element "
"should come before the second, 0 if the first and second elements should "
"have the same ordering, and 1 if the first element should come after the "
"second."
msgstr ""

#: ./api-array.html:47
msgid ""
"The \"user_data\" pointer is passed to your comparison function. Pass "
"<code>NULL</code> if you do not need to associate the elements in your array "
"with additional information."
msgstr ""

#: ./api-array.html:48
msgid ""
"The <a href='#cupsArrayNew2'><code>cupsArrayNew2</code></a> function adds "
"two more arguments to support hashed lookups, which can potentially provide "
"instantaneous (\"O(1)\") lookups in your array:"
msgstr ""

#: ./api-array.html:49
msgid ""
"The hash function (type <a "
"href=\"#cups_ahash_func_t\"><code>cups_ahash_func_t</code></a>) should return "
"a number from 0 to (hash_size-1) that (hopefully) uniquely identifies the "
"element and is called whenever you look up an element in the array with <a "
"href='#cupsArrayFind'><code>cupsArrayFind</code></a>. The hash size is only "
"limited by available memory, but generally should not be larger than 16384 "
"to realize any performance improvement."
msgstr ""

#: ./api-array.html:50
msgid ""
"Once you have created the array, you add elements using the <a "
"href='#cupsArrayAdd'><code>cupsArrayAdd</code></a> <a "
"href='#cupsArrayInsert'><code>cupsArrayInsert</code></a> functions. The "
"first function adds an element to the array, adding the new element after "
"any elements that have the same order, while the second inserts the element "
"before others with the same order. For unsorted arrays, <a "
"href='#cupsArrayAdd'><code>cupsArrayAdd</code></a> appends the element to "
"the end of the array while <a "
"href='#cupsArrayInsert'><code>cupsArrayInsert</code></a> inserts the element "
"at the beginning of the array. For example, the following code creates a "
"sorted array of character strings:"
msgstr ""

#: ./api-array.html:51
msgid ""
"Elements are removed using the <a "
"href='#cupsArrayRemove'><code>cupsArrayRemove</code></a> function, for "
"example:"
msgstr ""

#: ./api-array.html:52
msgid ""
"Finally, you free the memory used by the array using the <a "
"href='#cupsArrayDelete'><code>cupsArrayDelete</code></a> function. All of "
"the memory for the array and hash table (if any) is freed, however <em>CUPS "
"does not free the elements</em> - if necessary, you must allocate and free "
"the elements yourself."
msgstr ""

#: ./api-array.html:53
msgctxt "./api-array.html:53"
msgid "Finding and Enumerating Elements"
msgstr ""

#: ./api-array.html:54
msgid ""
"CUPS provides several functions to find and enumerate elements in an array. "
"Each one sets or updates a \"current index\" into the array, such that future "
"lookups will start where the last one left off:"
msgstr ""

#: ./api-array.html:55
msgctxt "./api-array.html:55"
msgid "cupsArrayFind"
msgstr ""

#: ./api-array.html:56
msgid "Returns the first matching element."
msgstr ""

#: ./api-array.html:57
msgctxt "./api-array.html:57"
msgid "cupsArrayFirst"
msgstr ""

#: ./api-array.html:58
msgid "Returns the first element in the array."
msgstr ""

#: ./api-array.html:59
msgctxt "./api-array.html:59"
msgid "cupsArrayIndex"
msgstr ""

#: ./api-array.html:60
msgid "Returns the Nth element in the array, starting at 0."
msgstr ""

#: ./api-array.html:61
msgctxt "./api-array.html:61"
msgid "cupsArrayLast"
msgstr ""

#: ./api-array.html:62
msgid "Returns the last element in the array."
msgstr ""

#: ./api-array.html:63
msgctxt "./api-array.html:63"
msgid "cupsArrayNext"
msgstr ""

#: ./api-array.html:64
msgid "Returns the next element in the array."
msgstr ""

#: ./api-array.html:65
msgctxt "./api-array.html:65"
msgid "cupsArrayPrev"
msgstr ""

#: ./api-array.html:66
msgid "Returns the previous element in the array."
msgstr ""

#: ./api-array.html:67
msgid ""
"Each of these functions returns <code>NULL</code> when there is no "
"corresponding element.  For example, a simple <code>for</code> loop using "
"the <a href='#cupsArrayFirst'><code>cupsArrayFirst</code></a> and <a "
"href='#cupsArrayNext'><code>cupsArrayNext</code></a> functions will "
"enumerate all of the strings in our previous example:"
msgstr ""

#: ./api-array.html:68
msgctxt "./api-array.html:68"
msgid "Functions"
msgstr ""

#: ./api-array.html:69
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a name=\"cupsArrayAdd\">cupsArrayAdd"
msgstr ""

#: ./api-array.html:70
msgid "Add an element to the array."
msgstr ""

#: ./api-array.html:71
msgid ""
"int cupsArrayAdd (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a,<br> &nbsp;&nbsp;&nbsp;&nbsp;void "
"*e<br> );"
msgstr ""

#: ./api-array.html:72
msgctxt "./api-array.html:72"
msgid "Parameters"
msgstr ""

#: ./api-array.html:73
msgctxt "./api-array.html:73"
msgid "a"
msgstr ""

#: ./api-array.html:74
msgctxt "./api-array.html:74"
msgid "Array"
msgstr ""

#: ./api-array.html:75
msgctxt "./api-array.html:75"
msgid "e"
msgstr ""

#: ./api-array.html:76
msgctxt "./api-array.html:76"
msgid "Element"
msgstr ""

#: ./api-array.html:77
msgctxt "./api-array.html:77"
msgid "Return Value"
msgstr ""

#: ./api-array.html:78
msgctxt "./api-array.html:78"
msgid "1 on success, 0 on failure"
msgstr ""

#: ./api-array.html:79
msgctxt "./api-array.html:79"
msgid "Discussion"
msgstr ""

#: ./api-array.html:80
msgid ""
"When adding an element to a sorted array, non-unique elements are appended "
"at the end of the run of identical elements.  For unsorted arrays, the "
"element is appended to the end of the array."
msgstr ""

#: ./api-array.html:81
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayClear\">cupsArrayClear"
msgstr ""

#: ./api-array.html:82
msgid "Clear the array."
msgstr ""

#: ./api-array.html:83
msgid ""
"void cupsArrayClear (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:84
msgctxt "./api-array.html:84"
msgid "Parameters"
msgstr ""

#: ./api-array.html:85
msgctxt "./api-array.html:85"
msgid "a"
msgstr ""

#: ./api-array.html:86
msgctxt "./api-array.html:86"
msgid "Array"
msgstr ""

#: ./api-array.html:87
msgctxt "./api-array.html:87"
msgid "Discussion"
msgstr ""

#: ./api-array.html:88
msgid ""
"This function is equivalent to removing all elements in the array. The "
"caller is responsible for freeing the memory used by the elements "
"themselves."
msgstr ""

#: ./api-array.html:89
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayCount\">cupsArrayCount"
msgstr ""

#: ./api-array.html:90
msgid "Get the number of elements in the array."
msgstr ""

#: ./api-array.html:91
msgid ""
"int cupsArrayCount (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:92
msgctxt "./api-array.html:92"
msgid "Parameters"
msgstr ""

#: ./api-array.html:93
msgctxt "./api-array.html:93"
msgid "a"
msgstr ""

#: ./api-array.html:94
msgctxt "./api-array.html:94"
msgid "Array"
msgstr ""

#: ./api-array.html:95
msgctxt "./api-array.html:95"
msgid "Return Value"
msgstr ""

#: ./api-array.html:96
msgid "Number of elements"
msgstr ""

#: ./api-array.html:97
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayCurrent\">cupsArrayCurrent"
msgstr ""

#: ./api-array.html:98
msgid "Return the current element in the array."
msgstr ""

#: ./api-array.html:99
msgid ""
"void *cupsArrayCurrent (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:100
msgctxt "./api-array.html:100"
msgid "Parameters"
msgstr ""

#: ./api-array.html:101
msgctxt "./api-array.html:101"
msgid "a"
msgstr ""

#: ./api-array.html:102
msgctxt "./api-array.html:102"
msgid "Array"
msgstr ""

#: ./api-array.html:103
msgctxt "./api-array.html:103"
msgid "Return Value"
msgstr ""

#: ./api-array.html:104
msgctxt "./api-array.html:104"
msgid "Element"
msgstr ""

#: ./api-array.html:105
msgctxt "./api-array.html:105"
msgid "Discussion"
msgstr ""

#: ./api-array.html:106
msgctxt "./api-array.html:106"
msgid ""
"The current element is undefined until you call <a "
"href=\"#cupsArrayFind\"><code>cupsArrayFind</code></a>, <a "
"href=\"#cupsArrayFirst\"><code>cupsArrayFirst</code></a>, or <a "
"href=\"#cupsArrayIndex\"><code>cupsArrayIndex</code></a>, or <a "
"href=\"#cupsArrayLast\"><code>cupsArrayLast</code></a>."
msgstr ""

#: ./api-array.html:107
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayDelete\">cupsArrayDelete"
msgstr ""

#: ./api-array.html:108
msgid "Free all memory used by the array."
msgstr ""

#: ./api-array.html:109
msgid ""
"void cupsArrayDelete (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:110
msgctxt "./api-array.html:110"
msgid "Parameters"
msgstr ""

#: ./api-array.html:111
msgctxt "./api-array.html:111"
msgid "a"
msgstr ""

#: ./api-array.html:112
msgctxt "./api-array.html:112"
msgid "Array"
msgstr ""

#: ./api-array.html:113
msgctxt "./api-array.html:113"
msgid "Discussion"
msgstr ""

#: ./api-array.html:114
msgid ""
"The caller is responsible for freeing the memory used by the elements "
"themselves."
msgstr ""

#: ./api-array.html:115
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a name=\"cupsArrayDup\">cupsArrayDup"
msgstr ""

#: ./api-array.html:116
msgid "Duplicate the array."
msgstr ""

#: ./api-array.html:117
msgid ""
"<a href=\"#cups_array_t\">cups_array_t</a> *cupsArrayDup (<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;<a href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:118
msgctxt "./api-array.html:118"
msgid "Parameters"
msgstr ""

#: ./api-array.html:119
msgctxt "./api-array.html:119"
msgid "a"
msgstr ""

#: ./api-array.html:120
msgctxt "./api-array.html:120"
msgid "Array"
msgstr ""

#: ./api-array.html:121
msgctxt "./api-array.html:121"
msgid "Return Value"
msgstr ""

#: ./api-array.html:122
msgid "Duplicate array"
msgstr ""

#: ./api-array.html:123
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayFind\">cupsArrayFind"
msgstr ""

#: ./api-array.html:124
msgid "Find an element in the array."
msgstr ""

#: ./api-array.html:125
msgid ""
"void *cupsArrayFind (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a,<br> &nbsp;&nbsp;&nbsp;&nbsp;void "
"*e<br> );"
msgstr ""

#: ./api-array.html:126
msgctxt "./api-array.html:126"
msgid "Parameters"
msgstr ""

#: ./api-array.html:127
msgctxt "./api-array.html:127"
msgid "a"
msgstr ""

#: ./api-array.html:128
msgctxt "./api-array.html:128"
msgid "Array"
msgstr ""

#: ./api-array.html:129
msgctxt "./api-array.html:129"
msgid "e"
msgstr ""

#: ./api-array.html:130
msgctxt "./api-array.html:130"
msgid "Element"
msgstr ""

#: ./api-array.html:131
msgctxt "./api-array.html:131"
msgid "Return Value"
msgstr ""

#: ./api-array.html:132
msgid "Element found or <code>NULL</code>"
msgstr ""

#: ./api-array.html:133
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayFirst\">cupsArrayFirst"
msgstr ""

#: ./api-array.html:134
msgid "Get the first element in the array."
msgstr ""

#: ./api-array.html:135
msgid ""
"void *cupsArrayFirst (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:136
msgctxt "./api-array.html:136"
msgid "Parameters"
msgstr ""

#: ./api-array.html:137
msgctxt "./api-array.html:137"
msgid "a"
msgstr ""

#: ./api-array.html:138
msgctxt "./api-array.html:138"
msgid "Array"
msgstr ""

#: ./api-array.html:139
msgctxt "./api-array.html:139"
msgid "Return Value"
msgstr ""

#: ./api-array.html:140
msgid "First element or <code>NULL</code> if the array is empty"
msgstr ""

#: ./api-array.html:141
msgid ""
"&nbsp;CUPS 1.3/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayGetIndex\">cupsArrayGetIndex"
msgstr ""

#: ./api-array.html:142
msgid "Get the index of the current element."
msgstr ""

#: ./api-array.html:143
msgid ""
"int cupsArrayGetIndex (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:144
msgctxt "./api-array.html:144"
msgid "Parameters"
msgstr ""

#: ./api-array.html:145
msgctxt "./api-array.html:145"
msgid "a"
msgstr ""

#: ./api-array.html:146
msgctxt "./api-array.html:146"
msgid "Array"
msgstr ""

#: ./api-array.html:147
msgctxt "./api-array.html:147"
msgid "Return Value"
msgstr ""

#: ./api-array.html:148
msgid "Index of the current element, starting at 0"
msgstr ""

#: ./api-array.html:149
msgctxt "./api-array.html:149"
msgid "Discussion"
msgstr ""

#: ./api-array.html:150
msgctxt "./api-array.html:150"
msgid ""
"The current element is undefined until you call <a "
"href=\"#cupsArrayFind\"><code>cupsArrayFind</code></a>, <a "
"href=\"#cupsArrayFirst\"><code>cupsArrayFirst</code></a>, or <a "
"href=\"#cupsArrayIndex\"><code>cupsArrayIndex</code></a>, or <a "
"href=\"#cupsArrayLast\"><code>cupsArrayLast</code></a>."
msgstr ""

#: ./api-array.html:151
msgid ""
"&nbsp;CUPS 1.3/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayGetInsert\">cupsArrayGetInsert"
msgstr ""

#: ./api-array.html:152
msgid "Get the index of the last inserted element."
msgstr ""

#: ./api-array.html:153
msgid ""
"int cupsArrayGetInsert (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:154
msgctxt "./api-array.html:154"
msgid "Parameters"
msgstr ""

#: ./api-array.html:155
msgctxt "./api-array.html:155"
msgid "a"
msgstr ""

#: ./api-array.html:156
msgctxt "./api-array.html:156"
msgid "Array"
msgstr ""

#: ./api-array.html:157
msgctxt "./api-array.html:157"
msgid "Return Value"
msgstr ""

#: ./api-array.html:158
msgid "Index of the last inserted element, starting at 0"
msgstr ""

#: ./api-array.html:159
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayIndex\">cupsArrayIndex"
msgstr ""

#: ./api-array.html:160
msgid "Get the N-th element in the array."
msgstr ""

#: ./api-array.html:161
msgid ""
"void *cupsArrayIndex (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a,<br> &nbsp;&nbsp;&nbsp;&nbsp;int "
"n<br> );"
msgstr ""

#: ./api-array.html:162
msgctxt "./api-array.html:162"
msgid "Parameters"
msgstr ""

#: ./api-array.html:163
msgctxt "./api-array.html:163"
msgid "a"
msgstr ""

#: ./api-array.html:164
msgctxt "./api-array.html:164"
msgid "Array"
msgstr ""

#: ./api-array.html:165
msgid "n"
msgstr ""

#: ./api-array.html:166
msgid "Index into array, starting at 0"
msgstr ""

#: ./api-array.html:167
msgctxt "./api-array.html:167"
msgid "Return Value"
msgstr ""

#: ./api-array.html:168
msgid "N-th element or <code>NULL</code>"
msgstr ""

#: ./api-array.html:169
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayInsert\">cupsArrayInsert"
msgstr ""

#: ./api-array.html:170
msgid "Insert an element in the array."
msgstr ""

#: ./api-array.html:171
msgid ""
"int cupsArrayInsert (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a,<br> &nbsp;&nbsp;&nbsp;&nbsp;void "
"*e<br> );"
msgstr ""

#: ./api-array.html:172
msgctxt "./api-array.html:172"
msgid "Parameters"
msgstr ""

#: ./api-array.html:173
msgctxt "./api-array.html:173"
msgid "a"
msgstr ""

#: ./api-array.html:174
msgctxt "./api-array.html:174"
msgid "Array"
msgstr ""

#: ./api-array.html:175
msgctxt "./api-array.html:175"
msgid "e"
msgstr ""

#: ./api-array.html:176
msgctxt "./api-array.html:176"
msgid "Element"
msgstr ""

#: ./api-array.html:177
msgctxt "./api-array.html:177"
msgid "Return Value"
msgstr ""

#: ./api-array.html:178
msgid "0 on failure, 1 on success"
msgstr ""

#: ./api-array.html:179
msgctxt "./api-array.html:179"
msgid "Discussion"
msgstr ""

#: ./api-array.html:180
msgid ""
"When inserting an element in a sorted array, non-unique elements are "
"inserted at the beginning of the run of identical elements.  For unsorted "
"arrays, the element is inserted at the beginning of the array."
msgstr ""

#: ./api-array.html:181
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayLast\">cupsArrayLast"
msgstr ""

#: ./api-array.html:182
msgid "Get the last element in the array."
msgstr ""

#: ./api-array.html:183
msgid ""
"void *cupsArrayLast (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:184
msgctxt "./api-array.html:184"
msgid "Parameters"
msgstr ""

#: ./api-array.html:185
msgctxt "./api-array.html:185"
msgid "a"
msgstr ""

#: ./api-array.html:186
msgctxt "./api-array.html:186"
msgid "Array"
msgstr ""

#: ./api-array.html:187
msgctxt "./api-array.html:187"
msgid "Return Value"
msgstr ""

#: ./api-array.html:188
msgid "Last element or <code>NULL</code> if the array is empty"
msgstr ""

#: ./api-array.html:189
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a name=\"cupsArrayNew\">cupsArrayNew"
msgstr ""

#: ./api-array.html:190
msgid "Create a new array."
msgstr ""

#: ./api-array.html:191
msgid ""
"<a href=\"#cups_array_t\">cups_array_t</a> *cupsArrayNew (<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;<a href=\"#cups_array_func_t\">cups_array_func_t</a> "
"f,<br> &nbsp;&nbsp;&nbsp;&nbsp;void *d<br> );"
msgstr ""

#: ./api-array.html:192
msgctxt "./api-array.html:192"
msgid "Parameters"
msgstr ""

#: ./api-array.html:193
msgctxt "./api-array.html:193"
msgid "f"
msgstr ""

#: ./api-array.html:194
msgctxt "./api-array.html:194"
msgid "Comparison function or <code>NULL</code> for an unsorted array"
msgstr ""

#: ./api-array.html:195
msgctxt "./api-array.html:195"
msgid "d"
msgstr ""

#: ./api-array.html:196
msgid "User data pointer or <code>NULL</code>"
msgstr ""

#: ./api-array.html:197
msgctxt "./api-array.html:197"
msgid "Return Value"
msgstr ""

#: ./api-array.html:198
msgctxt "./api-array.html:198"
msgid "Array"
msgstr ""

#: ./api-array.html:199
msgctxt "./api-array.html:199"
msgid "Discussion"
msgstr ""

#: ./api-array.html:200
msgid ""
"The comparison function (&quot;f&quot;) is used to create a sorted array. "
"The function receives pointers to two elements and the user data pointer "
"(&quot;d&quot;) - the user data pointer argument can safely be omitted when "
"not required so functions like <code>strcmp</code> can be used for sorted "
"string arrays."
msgstr ""

#: ./api-array.html:201
msgid ""
"&nbsp;CUPS 1.3/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayNew2\">cupsArrayNew2"
msgstr ""

#: ./api-array.html:202
msgid "Create a new array with hash."
msgstr ""

#: ./api-array.html:203
msgid ""
"<a href=\"#cups_array_t\">cups_array_t</a> *cupsArrayNew2 (<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;<a href=\"#cups_array_func_t\">cups_array_func_t</a> "
"f,<br> &nbsp;&nbsp;&nbsp;&nbsp;void *d,<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_ahash_func_t\">cups_ahash_func_t</a> h,<br> "
"&nbsp;&nbsp;&nbsp;&nbsp;int hsize<br> );"
msgstr ""

#: ./api-array.html:204
msgctxt "./api-array.html:204"
msgid "Parameters"
msgstr ""

#: ./api-array.html:205
msgctxt "./api-array.html:205"
msgid "f"
msgstr ""

#: ./api-array.html:206
msgctxt "./api-array.html:206"
msgid "Comparison function or <code>NULL</code> for an unsorted array"
msgstr ""

#: ./api-array.html:207
msgctxt "./api-array.html:207"
msgid "d"
msgstr ""

#: ./api-array.html:208
msgid "User data or <code>NULL</code>"
msgstr ""

#: ./api-array.html:209
msgid "h"
msgstr ""

#: ./api-array.html:210
msgid "Hash function or <code>NULL</code> for unhashed lookups"
msgstr ""

#: ./api-array.html:211
msgid "hsize"
msgstr ""

#: ./api-array.html:212
msgid "Hash size (&gt;= 0)"
msgstr ""

#: ./api-array.html:213
msgctxt "./api-array.html:213"
msgid "Return Value"
msgstr ""

#: ./api-array.html:214
msgctxt "./api-array.html:214"
msgid "Array"
msgstr ""

#: ./api-array.html:215
msgctxt "./api-array.html:215"
msgid "Discussion"
msgstr ""

#: ./api-array.html:216
msgid ""
"The comparison function (&quot;f&quot;) is used to create a sorted array. "
"The function receives pointers to two elements and the user data pointer "
"(&quot;d&quot;) - the user data pointer argument can safely be omitted when "
"not required so functions like <code>strcmp</code> can be used for sorted "
"string arrays.<br> <br> The hash function (&quot;h&quot;) is used to "
"implement cached lookups with the specified hash size (&quot;hsize&quot;)."
msgstr ""

#: ./api-array.html:217
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayNext\">cupsArrayNext"
msgstr ""

#: ./api-array.html:218
msgid "Get the next element in the array."
msgstr ""

#: ./api-array.html:219
msgid ""
"void *cupsArrayNext (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:220
msgctxt "./api-array.html:220"
msgid "Parameters"
msgstr ""

#: ./api-array.html:221
msgctxt "./api-array.html:221"
msgid "a"
msgstr ""

#: ./api-array.html:222
msgctxt "./api-array.html:222"
msgid "Array"
msgstr ""

#: ./api-array.html:223
msgctxt "./api-array.html:223"
msgid "Return Value"
msgstr ""

#: ./api-array.html:224
msgid "Next element or <code>NULL</code>"
msgstr ""

#: ./api-array.html:225
msgctxt "./api-array.html:225"
msgid "Discussion"
msgstr ""

#: ./api-array.html:226
msgid ""
"This function is equivalent to &quot;cupsArrayIndex(a, cupsArrayGetIndex(a) "
"+ 1)&quot;.<br> <br> The next element is undefined until you call <a "
"href=\"#cupsArrayFind\"><code>cupsArrayFind</code></a>, <a "
"href=\"#cupsArrayFirst\"><code>cupsArrayFirst</code></a>, or <a "
"href=\"#cupsArrayIndex\"><code>cupsArrayIndex</code></a>, or <a "
"href=\"#cupsArrayLast\"><code>cupsArrayLast</code></a> to set the current "
"element."
msgstr ""

#: ./api-array.html:227
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayPrev\">cupsArrayPrev"
msgstr ""

#: ./api-array.html:228
msgid "Get the previous element in the array."
msgstr ""

#: ./api-array.html:229
msgid ""
"void *cupsArrayPrev (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:230
msgctxt "./api-array.html:230"
msgid "Parameters"
msgstr ""

#: ./api-array.html:231
msgctxt "./api-array.html:231"
msgid "a"
msgstr ""

#: ./api-array.html:232
msgctxt "./api-array.html:232"
msgid "Array"
msgstr ""

#: ./api-array.html:233
msgctxt "./api-array.html:233"
msgid "Return Value"
msgstr ""

#: ./api-array.html:234
msgid "Previous element or <code>NULL</code>"
msgstr ""

#: ./api-array.html:235
msgctxt "./api-array.html:235"
msgid "Discussion"
msgstr ""

#: ./api-array.html:236
msgid ""
"This function is equivalent to &quot;cupsArrayIndex(a, cupsArrayGetIndex(a) "
"- 1)&quot;.<br> <br> The previous element is undefined until you call <a "
"href=\"#cupsArrayFind\"><code>cupsArrayFind</code></a>, <a "
"href=\"#cupsArrayFirst\"><code>cupsArrayFirst</code></a>, or <a "
"href=\"#cupsArrayIndex\"><code>cupsArrayIndex</code></a>, or <a "
"href=\"#cupsArrayLast\"><code>cupsArrayLast</code></a> to set the current "
"element."
msgstr ""

#: ./api-array.html:237
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayRemove\">cupsArrayRemove"
msgstr ""

#: ./api-array.html:238
msgid "Remove an element from the array."
msgstr ""

#: ./api-array.html:239
msgid ""
"int cupsArrayRemove (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a,<br> &nbsp;&nbsp;&nbsp;&nbsp;void "
"*e<br> );"
msgstr ""

#: ./api-array.html:240
msgctxt "./api-array.html:240"
msgid "Parameters"
msgstr ""

#: ./api-array.html:241
msgctxt "./api-array.html:241"
msgid "a"
msgstr ""

#: ./api-array.html:242
msgctxt "./api-array.html:242"
msgid "Array"
msgstr ""

#: ./api-array.html:243
msgctxt "./api-array.html:243"
msgid "e"
msgstr ""

#: ./api-array.html:244
msgctxt "./api-array.html:244"
msgid "Element"
msgstr ""

#: ./api-array.html:245
msgctxt "./api-array.html:245"
msgid "Return Value"
msgstr ""

#: ./api-array.html:246
msgctxt "./api-array.html:246"
msgid "1 on success, 0 on failure"
msgstr ""

#: ./api-array.html:247
msgctxt "./api-array.html:247"
msgid "Discussion"
msgstr ""

#: ./api-array.html:248
msgid ""
"If more than one element matches &quot;e&quot;, only the first matching "
"element is removed.<br> <br> The caller is responsible for freeing the "
"memory used by the removed element."
msgstr ""

#: ./api-array.html:249
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayRestore\">cupsArrayRestore"
msgstr ""

#: ./api-array.html:250
msgid ""
"Reset the current element to the last <a "
"href=\"#cupsArraySave\"><code>cupsArraySave</code></a>."
msgstr ""

#: ./api-array.html:251
msgid ""
"void *cupsArrayRestore (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:252
msgctxt "./api-array.html:252"
msgid "Parameters"
msgstr ""

#: ./api-array.html:253
msgctxt "./api-array.html:253"
msgid "a"
msgstr ""

#: ./api-array.html:254
msgctxt "./api-array.html:254"
msgid "Array"
msgstr ""

#: ./api-array.html:255
msgctxt "./api-array.html:255"
msgid "Return Value"
msgstr ""

#: ./api-array.html:256
msgid "New current element"
msgstr ""

#: ./api-array.html:257
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArraySave\">cupsArraySave"
msgstr ""

#: ./api-array.html:258
msgid ""
"Mark the current element for a later <a "
"href=\"#cupsArrayRestore\"><code>cupsArrayRestore</code></a>."
msgstr ""

#: ./api-array.html:259
msgid ""
"int cupsArraySave (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:260
msgctxt "./api-array.html:260"
msgid "Parameters"
msgstr ""

#: ./api-array.html:261
msgctxt "./api-array.html:261"
msgid "a"
msgstr ""

#: ./api-array.html:262
msgctxt "./api-array.html:262"
msgid "Array"
msgstr ""

#: ./api-array.html:263
msgctxt "./api-array.html:263"
msgid "Return Value"
msgstr ""

#: ./api-array.html:264
msgctxt "./api-array.html:264"
msgid "1 on success, 0 on failure"
msgstr ""

#: ./api-array.html:265
msgctxt "./api-array.html:265"
msgid "Discussion"
msgstr ""

#: ./api-array.html:266
msgid ""
"The current element is undefined until you call <a "
"href=\"#cupsArrayFind\"><code>cupsArrayFind</code></a>, <a "
"href=\"#cupsArrayFirst\"><code>cupsArrayFirst</code></a>, or <a "
"href=\"#cupsArrayIndex\"><code>cupsArrayIndex</code></a>, or <a "
"href=\"#cupsArrayLast\"><code>cupsArrayLast</code></a> to set the current "
"element.<br> <br> The save/restore stack is guaranteed to be at least 32 "
"elements deep."
msgstr ""

#: ./api-array.html:267
msgid ""
"&nbsp;CUPS 1.2/Mac OS X 10.5&nbsp;</span><a "
"name=\"cupsArrayUserData\">cupsArrayUserData"
msgstr ""

#: ./api-array.html:268
msgid "Return the user data for an array."
msgstr ""

#: ./api-array.html:269
msgid ""
"void *cupsArrayUserData (<br> &nbsp;&nbsp;&nbsp;&nbsp;<a "
"href=\"#cups_array_t\">cups_array_t</a> *a<br> );"
msgstr ""

#: ./api-array.html:270
msgctxt "./api-array.html:270"
msgid "Parameters"
msgstr ""

#: ./api-array.html:271
msgctxt "./api-array.html:271"
msgid "a"
msgstr ""

#: ./api-array.html:272
msgctxt "./api-array.html:272"
msgid "Array"
msgstr ""

#: ./api-array.html:273
msgctxt "./api-array.html:273"
msgid "Return Value"
msgstr ""

#: ./api-array.html:274
msgid "User data"
msgstr ""

#: ./api-array.html:275
msgctxt "./api-array.html:275"
msgid "Data Types"
msgstr ""

#: ./api-array.html:276
msgctxt "./api-array.html:276"
msgid "cups_ahash_func_t"
msgstr ""

#: ./api-array.html:277
msgid "Array hash function"
msgstr ""

#: ./api-array.html:278
msgid "typedef int (*cups_ahash_func_t)(void *element, void *data);"
msgstr ""

#: ./api-array.html:279
msgctxt "./api-array.html:279"
msgid "cups_array_func_t"
msgstr ""

#: ./api-array.html:280
msgid "Array comparison function"
msgstr ""

#: ./api-array.html:281
msgid ""
"typedef int (*cups_array_func_t)(void *first, void *second, void *data);"
msgstr ""

#: ./api-array.html:282
msgctxt "./api-array.html:282"
msgid "cups_array_t"
msgstr ""

#: ./api-array.html:283
msgid "CUPS array type"
msgstr ""

#: ./api-array.html:284
msgid "typedef struct _cups_array_s cups_array_t;"
msgstr ""