| 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 */
|
|---|