reference/filesystem/constants.xml
850ac483c876e767048222f9133e2498145f9f4a
850ac483c876e767048222f9133e2498145f9f4a
...
...
@@ -81,87 +81,114 @@
81
81
</simpara>
82
82
</listitem>
83
83
</varlistentry>
84
-
<varlistentry xml:id="constant.glob-brace">
84
+
</variablelist>
85
+
<variablelist xml:id="constant.glob-constant-variablelist">
86
+
<varlistentry>
85
87
<term>
86
88
<constant>GLOB_BRACE</constant>
87
89
(<type>int</type>)
88
90
</term>
89
91
<listitem>
90
92
<simpara>
91
-
93
+
Expands {a,b,c} to match 'a', 'b', or 'c'
94
+
</simpara>
95
+
<note>
96
+
<simpara>
97
+
<constant>GLOB_BRACE</constant> is not available on some non GNU systems,
98
+
like Solaris or Alpine Linux.
99
+
</simpara>
100
+
</note>
101
+
</listitem>
102
+
</varlistentry>
103
+
<varlistentry>
104
+
<term>
105
+
<constant>GLOB_ERR</constant>
106
+
(<type>int</type>)
107
+
</term>
108
+
<listitem>
109
+
<simpara>
110
+
Stop on read errors (like unreadable directories),
111
+
by default errors are ignored.
92
112
</simpara>
93
113
</listitem>
94
114
</varlistentry>
95
-
<varlistentry xml:id="constant.glob-onlydir">
115
+
<varlistentry>
96
116
<term>
97
117
<constant>GLOB_ONLYDIR</constant>
98
118
(<type>int</type>)
99
119
</term>
100
120
<listitem>
101
121
<simpara>
102
-
122
+
Return only directory entries which match the pattern
103
123
</simpara>
104
124
</listitem>
105
125
</varlistentry>
106
-
<varlistentry xml:id="constant.glob-mark">
126
+
<varlistentry>
107
127
<term>
108
128
<constant>GLOB_MARK</constant>
109
129
(<type>int</type>)
110
130
</term>
111
131
<listitem>
112
132
<simpara>
113
-
133
+
Adds a slash (a backslash on Windows) to each directory returned
114
134
</simpara>
115
135
</listitem>
116
136
</varlistentry>
117
-
<varlistentry xml:id="constant.glob-nosort">
137
+
<varlistentry>
118
138
<term>
119
139
<constant>GLOB_NOSORT</constant>
120
140
(<type>int</type>)
121
141
</term>
122
142
<listitem>
123
143
<simpara>
124
-
144
+
Return files as they appear in the directory (no sorting).
145
+
When this flag is not used, the pathnames are sorted alphabetically
125
146
</simpara>
126
147
</listitem>
127
148
</varlistentry>
128
-
<varlistentry xml:id="constant.glob-nocheck">
149
+
<varlistentry>
129
150
<term>
130
151
<constant>GLOB_NOCHECK</constant>
131
152
(<type>int</type>)
132
153
</term>
133
154
<listitem>
134
155
<simpara>
135
-
156
+
Return the search pattern if no files matching it were found
136
157
</simpara>
137
158
</listitem>
138
159
</varlistentry>
139
-
<varlistentry xml:id="constant.glob-noescape">
160
+
<varlistentry>
140
161
<term>
141
162
<constant>GLOB_NOESCAPE</constant>
142
163
(<type>int</type>)
143
164
</term>
144
165
<listitem>
145
166
<simpara>
146
-
167
+
Backslashes do not quote metacharacters
147
168
</simpara>
148
169
</listitem>
149
170
</varlistentry>
150
-
<varlistentry xml:id="constant.glob-available-flags">
171
+
<varlistentry>
151
172
<term>
152
173
<constant>GLOB_AVAILABLE_FLAGS</constant>
153
174
(<type>int</type>)
154
175
</term>
155
176
<listitem>
156
177
<simpara>
157
-
178
+
All <constant>GLOB_<replaceable>*</replaceable></constant> flags combined.
179
+
Equivalent to <literal>0</literal> | <constant>GLOB_BRACE</constant> |
180
+
<constant>GLOB_MARK</constant> | <constant>GLOB_NOSORT</constant> |
181
+
<constant>GLOB_NOCHECK</constant> | <constant>GLOB_NOESCAPE</constant> |
182
+
<constant>GLOB_ERR</constant> | <constant>GLOB_ONLYDIR</constant>
158
183
</simpara>
159
184
</listitem>
160
185
</varlistentry>
186
+
</variablelist>
187
+
<variablelist>
161
188
<varlistentry xml:id="constant.pathinfo-dirname">
162
189
<term>
163
190
<constant>PATHINFO_DIRNAME</constant>
164
-
(<type>int</type>)
191
+
(<type>int</type>)
165
192
</term>
166
193
<listitem>
167
194
<simpara>
...
...
@@ -172,7 +199,7 @@
172
199
<varlistentry xml:id="constant.pathinfo-basename">
173
200
<term>
174
201
<constant>PATHINFO_BASENAME</constant>
175
-
(<type>int</type>)
202
+
(<type>int</type>)
176
203
</term>
177
204
<listitem>
178
205
<simpara>
...
...
@@ -183,7 +210,7 @@
183
210
<varlistentry xml:id="constant.pathinfo-extension">
184
211
<term>
185
212
<constant>PATHINFO_EXTENSION</constant>
186
-
(<type>int</type>)
213
+
(<type>int</type>)
187
214
</term>
188
215
<listitem>
189
216
<simpara>
...
...
@@ -194,7 +221,7 @@
194
221
<varlistentry xml:id="constant.pathinfo-filename">
195
222
<term>
196
223
<constant>PATHINFO_FILENAME</constant>
197
-
(<type>int</type>)
224
+
(<type>int</type>)
198
225
</term>
199
226
<listitem>
200
227
<simpara>
...
...
@@ -205,7 +232,7 @@
205
232
<varlistentry xml:id="constant.file-use-include-path">
206
233
<term>
207
234
<constant>FILE_USE_INCLUDE_PATH</constant>
208
-
(<type>int</type>)
235
+
(<type>int</type>)
209
236
</term>
210
237
<listitem>
211
238
<simpara>
...
...
@@ -217,7 +244,7 @@
217
244
<varlistentry xml:id="constant.file-no-default-context">
218
245
<term>
219
246
<constant>FILE_NO_DEFAULT_CONTEXT</constant>
220
-
(<type>int</type>)
247
+
(<type>int</type>)
221
248
</term>
222
249
<listitem>
223
250
<simpara>
...
...
@@ -227,7 +254,7 @@
227
254
<varlistentry xml:id="constant.file-append">
228
255
<term>
229
256
<constant>FILE_APPEND</constant>
230
-
(<type>int</type>)
257
+
(<type>int</type>)
231
258
</term>
232
259
<listitem>
233
260
<simpara>
...
...
@@ -238,7 +265,7 @@
238
265
<varlistentry xml:id="constant.file-ignore-new-lines">
239
266
<term>
240
267
<constant>FILE_IGNORE_NEW_LINES</constant>
241
-
(<type>int</type>)
268
+
(<type>int</type>)
242
269
</term>
243
270
<listitem>
244
271
<simpara>
...
...
@@ -249,7 +276,7 @@
249
276
<varlistentry xml:id="constant.file-skip-empty-lines">
250
277
<term>
251
278
<constant>FILE_SKIP_EMPTY_LINES</constant>
252
-
(<type>int</type>)
279
+
(<type>int</type>)
253
280
</term>
254
281
<listitem>
255
282
<simpara>
...
...
@@ -261,7 +288,7 @@
261
288
<varlistentry xml:id="constant.file-binary">
262
289
<term>
263
290
<constant>FILE_BINARY</constant>
264
-
(<type>int</type>)
291
+
(<type>int</type>)
265
292
</term>
266
293
<listitem>
267
294
<para>
...
...
@@ -279,7 +306,7 @@
279
306
<varlistentry xml:id="constant.file-text">
280
307
<term>
281
308
<constant>FILE_TEXT</constant>
282
-
(<type>int</type>)
309
+
(<type>int</type>)
283
310
</term>
284
311
<listitem>
285
312
<para>
...
...
@@ -297,7 +324,7 @@
297
324
<varlistentry xml:id="constant.ini-scanner-normal">
298
325
<term>
299
326
<constant>INI_SCANNER_NORMAL</constant>
300
-
(<type>int</type>)
327
+
(<type>int</type>)
301
328
</term>
302
329
<listitem>
303
330
<simpara>
...
...
@@ -309,7 +336,7 @@
309
336
<varlistentry xml:id="constant.ini-scanner-raw">
310
337
<term>
311
338
<constant>INI_SCANNER_RAW</constant>
312
-
(<type>int</type>)
339
+
(<type>int</type>)
313
340
</term>
314
341
<listitem>
315
342
<simpara>
...
...
@@ -321,7 +348,7 @@
321
348
<varlistentry xml:id="constant.ini-scanner-typed">
322
349
<term>
323
350
<constant>INI_SCANNER_TYPED</constant>
324
-
(<type>int</type>)
351
+
(<type>int</type>)
325
352
</term>
326
353
<listitem>
327
354
<simpara>
...
...
@@ -333,7 +360,7 @@
333
360
<varlistentry xml:id="constant.fnm-noescape">
334
361
<term>
335
362
<constant>FNM_NOESCAPE</constant>
336
-
(<type>int</type>)
363
+
(<type>int</type>)
337
364
</term>
338
365
<listitem>
339
366
<simpara>
...
...
@@ -345,7 +372,7 @@
345
372
<varlistentry xml:id="constant.fnm-pathname">
346
373
<term>
347
374
<constant>FNM_PATHNAME</constant>
348
-
(<type>int</type>)
375
+
(<type>int</type>)
349
376
</term>
350
377
<listitem>
351
378
<simpara>
...
...
@@ -357,7 +384,7 @@
357
384
<varlistentry xml:id="constant.fnm-period">
358
385
<term>
359
386
<constant>FNM_PERIOD</constant>
360
-
(<type>int</type>)
387
+
(<type>int</type>)
361
388
</term>
362
389
<listitem>
363
390
<simpara>
...
...
@@ -369,7 +396,7 @@
369
396
<varlistentry xml:id="constant.fnm-casefold">
370
397
<term>
371
398
<constant>FNM_CASEFOLD</constant>
372
-
(<type>int</type>)
399
+
(<type>int</type>)
373
400
</term>
374
401
<listitem>
375
402
<simpara>
...
...
@@ -380,7 +407,6 @@
380
407
381
408
</variablelist>
382
409
</appendix>
383
-
384
410
<!-- Keep this comment at the end of the file
385
411
Local variables:
386
412
mode: sgml
387
413