1 | /* Word-wrapping and line-truncating streams
|
---|
2 | Copyright (C) 1997,1998,1999,2001,2002,2003 Free Software Foundation, Inc.
|
---|
3 | This file is part of the GNU C Library.
|
---|
4 | Written by Miles Bader <miles@gnu.ai.mit.edu>.
|
---|
5 |
|
---|
6 | The GNU C Library is free software; you can redistribute it and/or
|
---|
7 | modify it under the terms of the GNU Lesser General Public
|
---|
8 | License as published by the Free Software Foundation; either
|
---|
9 | version 2.1 of the License, or (at your option) any later version.
|
---|
10 |
|
---|
11 | The GNU C Library is distributed in the hope that it will be useful,
|
---|
12 | but WITHOUT ANY WARRANTY; without even the implied warranty of
|
---|
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
---|
14 | Lesser General Public License for more details.
|
---|
15 |
|
---|
16 | You should have received a copy of the GNU Lesser General Public
|
---|
17 | License along with the GNU C Library; if not, write to the Free
|
---|
18 | Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
|
---|
19 | 02111-1307 USA. */
|
---|
20 |
|
---|
21 | /* This package emulates glibc `line_wrap_stream' semantics for systems that
|
---|
22 | don't have that. */
|
---|
23 |
|
---|
24 | #ifdef HAVE_CONFIG_H
|
---|
25 | #include <config.h>
|
---|
26 | #endif
|
---|
27 |
|
---|
28 | #include <stdlib.h>
|
---|
29 | #include <string.h>
|
---|
30 | #include <errno.h>
|
---|
31 | #include <stdarg.h>
|
---|
32 | #include <ctype.h>
|
---|
33 |
|
---|
34 | #include "argp-fmtstream.h"
|
---|
35 | #include "argp-namefrob.h"
|
---|
36 |
|
---|
37 | #ifndef ARGP_FMTSTREAM_USE_LINEWRAP
|
---|
38 |
|
---|
39 | #ifndef isblank
|
---|
40 | #define isblank(ch) ((ch)==' ' || (ch)=='\t')
|
---|
41 | #endif
|
---|
42 |
|
---|
43 | #if defined _LIBC && defined USE_IN_LIBIO
|
---|
44 | # include <wchar.h>
|
---|
45 | # include <libio/libioP.h>
|
---|
46 | # define __vsnprintf(s, l, f, a) _IO_vsnprintf (s, l, f, a)
|
---|
47 | #endif
|
---|
48 |
|
---|
49 | #define INIT_BUF_SIZE 200
|
---|
50 | #define PRINTF_SIZE_GUESS 150
|
---|
51 | |
---|
52 |
|
---|
53 | /* Return an argp_fmtstream that outputs to STREAM, and which prefixes lines
|
---|
54 | written on it with LMARGIN spaces and limits them to RMARGIN columns
|
---|
55 | total. If WMARGIN >= 0, words that extend past RMARGIN are wrapped by
|
---|
56 | replacing the whitespace before them with a newline and WMARGIN spaces.
|
---|
57 | Otherwise, chars beyond RMARGIN are simply dropped until a newline.
|
---|
58 | Returns NULL if there was an error. */
|
---|
59 | argp_fmtstream_t
|
---|
60 | __argp_make_fmtstream (FILE *stream,
|
---|
61 | size_t lmargin, size_t rmargin, ssize_t wmargin)
|
---|
62 | {
|
---|
63 | argp_fmtstream_t fs;
|
---|
64 |
|
---|
65 | fs = (struct argp_fmtstream *) malloc (sizeof (struct argp_fmtstream));
|
---|
66 | if (fs != NULL)
|
---|
67 | {
|
---|
68 | fs->stream = stream;
|
---|
69 |
|
---|
70 | fs->lmargin = lmargin;
|
---|
71 | fs->rmargin = rmargin;
|
---|
72 | fs->wmargin = wmargin;
|
---|
73 | fs->point_col = 0;
|
---|
74 | fs->point_offs = 0;
|
---|
75 |
|
---|
76 | fs->buf = (char *) malloc (INIT_BUF_SIZE);
|
---|
77 | if (! fs->buf)
|
---|
78 | {
|
---|
79 | free (fs);
|
---|
80 | fs = 0;
|
---|
81 | }
|
---|
82 | else
|
---|
83 | {
|
---|
84 | fs->p = fs->buf;
|
---|
85 | fs->end = fs->buf + INIT_BUF_SIZE;
|
---|
86 | }
|
---|
87 | }
|
---|
88 |
|
---|
89 | return fs;
|
---|
90 | }
|
---|
91 | #if 0
|
---|
92 | /* Not exported. */
|
---|
93 | #ifdef weak_alias
|
---|
94 | weak_alias (__argp_make_fmtstream, argp_make_fmtstream)
|
---|
95 | #endif
|
---|
96 | #endif
|
---|
97 |
|
---|
98 | /* Flush FS to its stream, and free it (but don't close the stream). */
|
---|
99 | void
|
---|
100 | __argp_fmtstream_free (argp_fmtstream_t fs)
|
---|
101 | {
|
---|
102 | __argp_fmtstream_update (fs);
|
---|
103 | if (fs->p > fs->buf)
|
---|
104 | {
|
---|
105 | #ifdef USE_IN_LIBIO
|
---|
106 | if (_IO_fwide (fs->stream, 0) > 0)
|
---|
107 | __fwprintf (fs->stream, L"%.*s", (int) (fs->p - fs->buf), fs->buf);
|
---|
108 | else
|
---|
109 | #endif
|
---|
110 | fwrite_unlocked (fs->buf, 1, fs->p - fs->buf, fs->stream);
|
---|
111 | }
|
---|
112 | free (fs->buf);
|
---|
113 | free (fs);
|
---|
114 | }
|
---|
115 | #if 0
|
---|
116 | /* Not exported. */
|
---|
117 | #ifdef weak_alias
|
---|
118 | weak_alias (__argp_fmtstream_free, argp_fmtstream_free)
|
---|
119 | #endif
|
---|
120 | #endif
|
---|
121 | |
---|
122 |
|
---|
123 | /* Process FS's buffer so that line wrapping is done from POINT_OFFS to the
|
---|
124 | end of its buffer. This code is mostly from glibc stdio/linewrap.c. */
|
---|
125 | void
|
---|
126 | __argp_fmtstream_update (argp_fmtstream_t fs)
|
---|
127 | {
|
---|
128 | char *buf, *nl;
|
---|
129 | size_t len;
|
---|
130 |
|
---|
131 | /* Scan the buffer for newlines. */
|
---|
132 | buf = fs->buf + fs->point_offs;
|
---|
133 | while (buf < fs->p)
|
---|
134 | {
|
---|
135 | size_t r;
|
---|
136 |
|
---|
137 | if (fs->point_col == 0 && fs->lmargin != 0)
|
---|
138 | {
|
---|
139 | /* We are starting a new line. Print spaces to the left margin. */
|
---|
140 | const size_t pad = fs->lmargin;
|
---|
141 | if (fs->p + pad < fs->end)
|
---|
142 | {
|
---|
143 | /* We can fit in them in the buffer by moving the
|
---|
144 | buffer text up and filling in the beginning. */
|
---|
145 | memmove (buf + pad, buf, fs->p - buf);
|
---|
146 | fs->p += pad; /* Compensate for bigger buffer. */
|
---|
147 | memset (buf, ' ', pad); /* Fill in the spaces. */
|
---|
148 | buf += pad; /* Don't bother searching them. */
|
---|
149 | }
|
---|
150 | else
|
---|
151 | {
|
---|
152 | /* No buffer space for spaces. Must flush. */
|
---|
153 | size_t i;
|
---|
154 | for (i = 0; i < pad; i++)
|
---|
155 | {
|
---|
156 | #ifdef USE_IN_LIBIO
|
---|
157 | if (_IO_fwide (fs->stream, 0) > 0)
|
---|
158 | putwc_unlocked (L' ', fs->stream);
|
---|
159 | else
|
---|
160 | #endif
|
---|
161 | putc_unlocked (' ', fs->stream);
|
---|
162 | }
|
---|
163 | }
|
---|
164 | fs->point_col = pad;
|
---|
165 | }
|
---|
166 |
|
---|
167 | len = fs->p - buf;
|
---|
168 | nl = memchr (buf, '\n', len);
|
---|
169 |
|
---|
170 | if (fs->point_col < 0)
|
---|
171 | fs->point_col = 0;
|
---|
172 |
|
---|
173 | if (!nl)
|
---|
174 | {
|
---|
175 | /* The buffer ends in a partial line. */
|
---|
176 |
|
---|
177 | if (fs->point_col + len < fs->rmargin)
|
---|
178 | {
|
---|
179 | /* The remaining buffer text is a partial line and fits
|
---|
180 | within the maximum line width. Advance point for the
|
---|
181 | characters to be written and stop scanning. */
|
---|
182 | fs->point_col += len;
|
---|
183 | break;
|
---|
184 | }
|
---|
185 | else
|
---|
186 | /* Set the end-of-line pointer for the code below to
|
---|
187 | the end of the buffer. */
|
---|
188 | nl = fs->p;
|
---|
189 | }
|
---|
190 | else if (fs->point_col + (nl - buf) < (ssize_t) fs->rmargin)
|
---|
191 | {
|
---|
192 | /* The buffer contains a full line that fits within the maximum
|
---|
193 | line width. Reset point and scan the next line. */
|
---|
194 | fs->point_col = 0;
|
---|
195 | buf = nl + 1;
|
---|
196 | continue;
|
---|
197 | }
|
---|
198 |
|
---|
199 | /* This line is too long. */
|
---|
200 | r = fs->rmargin - 1;
|
---|
201 |
|
---|
202 | if (fs->wmargin < 0)
|
---|
203 | {
|
---|
204 | /* Truncate the line by overwriting the excess with the
|
---|
205 | newline and anything after it in the buffer. */
|
---|
206 | if (nl < fs->p)
|
---|
207 | {
|
---|
208 | memmove (buf + (r - fs->point_col), nl, fs->p - nl);
|
---|
209 | fs->p -= buf + (r - fs->point_col) - nl;
|
---|
210 | /* Reset point for the next line and start scanning it. */
|
---|
211 | fs->point_col = 0;
|
---|
212 | buf += r + 1; /* Skip full line plus \n. */
|
---|
213 | }
|
---|
214 | else
|
---|
215 | {
|
---|
216 | /* The buffer ends with a partial line that is beyond the
|
---|
217 | maximum line width. Advance point for the characters
|
---|
218 | written, and discard those past the max from the buffer. */
|
---|
219 | fs->point_col += len;
|
---|
220 | fs->p -= fs->point_col - r;
|
---|
221 | break;
|
---|
222 | }
|
---|
223 | }
|
---|
224 | else
|
---|
225 | {
|
---|
226 | /* Do word wrap. Go to the column just past the maximum line
|
---|
227 | width and scan back for the beginning of the word there.
|
---|
228 | Then insert a line break. */
|
---|
229 |
|
---|
230 | char *p, *nextline;
|
---|
231 | int i;
|
---|
232 |
|
---|
233 | p = buf + (r + 1 - fs->point_col);
|
---|
234 | while (p >= buf && !isblank (*p))
|
---|
235 | --p;
|
---|
236 | nextline = p + 1; /* This will begin the next line. */
|
---|
237 |
|
---|
238 | if (nextline > buf)
|
---|
239 | {
|
---|
240 | /* Swallow separating blanks. */
|
---|
241 | if (p >= buf)
|
---|
242 | do
|
---|
243 | --p;
|
---|
244 | while (p >= buf && isblank (*p));
|
---|
245 | nl = p + 1; /* The newline will replace the first blank. */
|
---|
246 | }
|
---|
247 | else
|
---|
248 | {
|
---|
249 | /* A single word that is greater than the maximum line width.
|
---|
250 | Oh well. Put it on an overlong line by itself. */
|
---|
251 | p = buf + (r + 1 - fs->point_col);
|
---|
252 | /* Find the end of the long word. */
|
---|
253 | do
|
---|
254 | ++p;
|
---|
255 | while (p < nl && !isblank (*p));
|
---|
256 | if (p == nl)
|
---|
257 | {
|
---|
258 | /* It already ends a line. No fussing required. */
|
---|
259 | fs->point_col = 0;
|
---|
260 | buf = nl + 1;
|
---|
261 | continue;
|
---|
262 | }
|
---|
263 | /* We will move the newline to replace the first blank. */
|
---|
264 | nl = p;
|
---|
265 | /* Swallow separating blanks. */
|
---|
266 | do
|
---|
267 | ++p;
|
---|
268 | while (isblank (*p));
|
---|
269 | /* The next line will start here. */
|
---|
270 | nextline = p;
|
---|
271 | }
|
---|
272 |
|
---|
273 | /* Note: There are a bunch of tests below for
|
---|
274 | NEXTLINE == BUF + LEN + 1; this case is where NL happens to fall
|
---|
275 | at the end of the buffer, and NEXTLINE is in fact empty (and so
|
---|
276 | we need not be careful to maintain its contents). */
|
---|
277 |
|
---|
278 | if ((nextline == buf + len + 1
|
---|
279 | ? fs->end - nl < fs->wmargin + 1
|
---|
280 | : nextline - (nl + 1) < fs->wmargin)
|
---|
281 | && fs->p > nextline)
|
---|
282 | {
|
---|
283 | /* The margin needs more blanks than we removed. */
|
---|
284 | if (fs->end - fs->p > fs->wmargin + 1)
|
---|
285 | /* Make some space for them. */
|
---|
286 | {
|
---|
287 | size_t mv = fs->p - nextline;
|
---|
288 | memmove (nl + 1 + fs->wmargin, nextline, mv);
|
---|
289 | nextline = nl + 1 + fs->wmargin;
|
---|
290 | len = nextline + mv - buf;
|
---|
291 | *nl++ = '\n';
|
---|
292 | }
|
---|
293 | else
|
---|
294 | /* Output the first line so we can use the space. */
|
---|
295 | {
|
---|
296 | #ifdef USE_IN_LIBIO
|
---|
297 | if (_IO_fwide (fs->stream, 0) > 0)
|
---|
298 | __fwprintf (fs->stream, L"%.*s\n",
|
---|
299 | (int) (nl - fs->buf), fs->buf);
|
---|
300 | else
|
---|
301 | #endif
|
---|
302 | {
|
---|
303 | if (nl > fs->buf)
|
---|
304 | fwrite_unlocked (fs->buf, 1, nl - fs->buf, fs->stream);
|
---|
305 | putc_unlocked ('\n', fs->stream);
|
---|
306 | }
|
---|
307 | len += buf - fs->buf;
|
---|
308 | nl = buf = fs->buf;
|
---|
309 | }
|
---|
310 | }
|
---|
311 | else
|
---|
312 | /* We can fit the newline and blanks in before
|
---|
313 | the next word. */
|
---|
314 | *nl++ = '\n';
|
---|
315 |
|
---|
316 | if (nextline - nl >= fs->wmargin
|
---|
317 | || (nextline == buf + len + 1 && fs->end - nextline >= fs->wmargin))
|
---|
318 | /* Add blanks up to the wrap margin column. */
|
---|
319 | for (i = 0; i < fs->wmargin; ++i)
|
---|
320 | *nl++ = ' ';
|
---|
321 | else
|
---|
322 | for (i = 0; i < fs->wmargin; ++i)
|
---|
323 | #ifdef USE_IN_LIBIO
|
---|
324 | if (_IO_fwide (fs->stream, 0) > 0)
|
---|
325 | putwc_unlocked (L' ', fs->stream);
|
---|
326 | else
|
---|
327 | #endif
|
---|
328 | putc_unlocked (' ', fs->stream);
|
---|
329 |
|
---|
330 | /* Copy the tail of the original buffer into the current buffer
|
---|
331 | position. */
|
---|
332 | if (nl < nextline)
|
---|
333 | memmove (nl, nextline, buf + len - nextline);
|
---|
334 | len -= nextline - buf;
|
---|
335 |
|
---|
336 | /* Continue the scan on the remaining lines in the buffer. */
|
---|
337 | buf = nl;
|
---|
338 |
|
---|
339 | /* Restore bufp to include all the remaining text. */
|
---|
340 | fs->p = nl + len;
|
---|
341 |
|
---|
342 | /* Reset the counter of what has been output this line. If wmargin
|
---|
343 | is 0, we want to avoid the lmargin getting added, so we set
|
---|
344 | point_col to a magic value of -1 in that case. */
|
---|
345 | fs->point_col = fs->wmargin ? fs->wmargin : -1;
|
---|
346 | }
|
---|
347 | }
|
---|
348 |
|
---|
349 | /* Remember that we've scanned as far as the end of the buffer. */
|
---|
350 | fs->point_offs = fs->p - fs->buf;
|
---|
351 | }
|
---|
352 | |
---|
353 |
|
---|
354 | /* Ensure that FS has space for AMOUNT more bytes in its buffer, either by
|
---|
355 | growing the buffer, or by flushing it. True is returned iff we succeed. */
|
---|
356 | int
|
---|
357 | __argp_fmtstream_ensure (struct argp_fmtstream *fs, size_t amount)
|
---|
358 | {
|
---|
359 | if ((size_t) (fs->end - fs->p) < amount)
|
---|
360 | {
|
---|
361 | ssize_t wrote;
|
---|
362 |
|
---|
363 | /* Flush FS's buffer. */
|
---|
364 | __argp_fmtstream_update (fs);
|
---|
365 |
|
---|
366 | #ifdef USE_IN_LIBIO
|
---|
367 | if (_IO_fwide (fs->stream, 0) > 0)
|
---|
368 | {
|
---|
369 | __fwprintf (fs->stream, L"%.*s", (int) (fs->p - fs->buf), fs->buf);
|
---|
370 | wrote = fs->p - fs->buf;
|
---|
371 | }
|
---|
372 | else
|
---|
373 | #endif
|
---|
374 | wrote = fwrite_unlocked (fs->buf, 1, fs->p - fs->buf, fs->stream);
|
---|
375 | if (wrote == fs->p - fs->buf)
|
---|
376 | {
|
---|
377 | fs->p = fs->buf;
|
---|
378 | fs->point_offs = 0;
|
---|
379 | }
|
---|
380 | else
|
---|
381 | {
|
---|
382 | fs->p -= wrote;
|
---|
383 | fs->point_offs -= wrote;
|
---|
384 | memmove (fs->buf, fs->buf + wrote, fs->p - fs->buf);
|
---|
385 | return 0;
|
---|
386 | }
|
---|
387 |
|
---|
388 | if ((size_t) (fs->end - fs->buf) < amount)
|
---|
389 | /* Gotta grow the buffer. */
|
---|
390 | {
|
---|
391 | size_t old_size = fs->end - fs->buf;
|
---|
392 | size_t new_size = old_size + amount;
|
---|
393 | char *new_buf;
|
---|
394 |
|
---|
395 | if (new_size < old_size || ! (new_buf = realloc (fs->buf, new_size)))
|
---|
396 | {
|
---|
397 | __set_errno (ENOMEM);
|
---|
398 | return 0;
|
---|
399 | }
|
---|
400 |
|
---|
401 | fs->buf = new_buf;
|
---|
402 | fs->end = new_buf + new_size;
|
---|
403 | fs->p = fs->buf;
|
---|
404 | }
|
---|
405 | }
|
---|
406 |
|
---|
407 | return 1;
|
---|
408 | }
|
---|
409 | |
---|
410 |
|
---|
411 | ssize_t
|
---|
412 | __argp_fmtstream_printf (struct argp_fmtstream *fs, const char *fmt, ...)
|
---|
413 | {
|
---|
414 | int out;
|
---|
415 | size_t avail;
|
---|
416 | size_t size_guess = PRINTF_SIZE_GUESS; /* How much space to reserve. */
|
---|
417 |
|
---|
418 | do
|
---|
419 | {
|
---|
420 | va_list args;
|
---|
421 |
|
---|
422 | if (! __argp_fmtstream_ensure (fs, size_guess))
|
---|
423 | return -1;
|
---|
424 |
|
---|
425 | va_start (args, fmt);
|
---|
426 | avail = fs->end - fs->p;
|
---|
427 | out = __vsnprintf (fs->p, avail, fmt, args);
|
---|
428 | va_end (args);
|
---|
429 | if ((size_t) out >= avail)
|
---|
430 | size_guess = out + 1;
|
---|
431 | }
|
---|
432 | while ((size_t) out >= avail);
|
---|
433 |
|
---|
434 | fs->p += out;
|
---|
435 |
|
---|
436 | return out;
|
---|
437 | }
|
---|
438 | #if 0
|
---|
439 | /* Not exported. */
|
---|
440 | #ifdef weak_alias
|
---|
441 | weak_alias (__argp_fmtstream_printf, argp_fmtstream_printf)
|
---|
442 | #endif
|
---|
443 | #endif
|
---|
444 |
|
---|
445 | #endif /* !ARGP_FMTSTREAM_USE_LINEWRAP */
|
---|