+++ /dev/null
-/* quotearg.h - quote arguments for output
-
- Copyright (C) 1998, 1999, 2000, 2001, 2002, 2004, 2006, 2008 Free
- Software Foundation, Inc.
-
- This program is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 3 of the License, or
- (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program. If not, see <http://www.gnu.org/licenses/>. */
-
-/* Written by Paul Eggert <eggert@twinsun.com> */
-
-#ifndef QUOTEARG_H_
-# define QUOTEARG_H_ 1
-
-# include <stddef.h>
-
-/* Basic quoting styles. For each style, an example is given on the
- input strings "simple", "\0 \t\n'\"\033?""?/\\", and "a:b", using
- quotearg_buffer, quotearg_mem, and quotearg_colon_mem with that
- style and the default flags and quoted characters. Note that the
- examples are shown here as valid C strings rather than what
- displays on a terminal (with "??/" as a trigraph for "\\"). */
-enum quoting_style
- {
- /* Output names as-is (ls --quoting-style=literal). Can result in
- embedded null bytes if QA_ELIDE_NULL_BYTES is not in
- effect.
-
- quotearg_buffer:
- "simple", "\0 \t\n'\"\033??/\\", "a:b"
- quotearg:
- "simple", " \t\n'\"\033??/\\", "a:b"
- quotearg_colon:
- "simple", " \t\n'\"\033??/\\", "a:b"
- */
- literal_quoting_style,
-
- /* Quote names for the shell if they contain shell metacharacters
- or would cause ambiguous output (ls --quoting-style=shell).
- Can result in embedded null bytes if QA_ELIDE_NULL_BYTES is not
- in effect.
-
- quotearg_buffer:
- "simple", "'\0 \t\n'\\''\"\033??/\\'", "a:b"
- quotearg:
- "simple", "' \t\n'\\''\"\033??/\\'", "a:b"
- quotearg_colon:
- "simple", "' \t\n'\\''\"\033??/\\'", "'a:b'"
- */
- shell_quoting_style,
-
- /* Quote names for the shell, even if they would normally not
- require quoting (ls --quoting-style=shell-always). Can result
- in embedded null bytes if QA_ELIDE_NULL_BYTES is not in effect.
- Behaves like shell_quoting_style if QA_ELIDE_OUTER_QUOTES is in
- effect.
-
- quotearg_buffer:
- "'simple'", "'\0 \t\n'\\''\"\033??/\\'", "'a:b'"
- quotearg:
- "'simple'", "' \t\n'\\''\"\033??/\\'", "'a:b'"
- quotearg_colon:
- "'simple'", "' \t\n'\\''\"\033??/\\'", "'a:b'"
- */
- shell_always_quoting_style,
-
- /* Quote names as for a C language string (ls --quoting-style=c).
- Behaves like c_maybe_quoting_style if QA_ELIDE_OUTER_QUOTES is
- in effect. Split into consecutive strings if
- QA_SPLIT_TRIGRAPHS.
-
- quotearg_buffer:
- "\"simple\"", "\"\\0 \\t\\n'\\\"\\033??/\\\\\"", "\"a:b\""
- quotearg:
- "\"simple\"", "\"\\0 \\t\\n'\\\"\\033??/\\\\\"", "\"a:b\""
- quotearg_colon:
- "\"simple\"", "\"\\0 \\t\\n'\\\"\\033??/\\\\\"", "\"a\\:b\""
- */
- c_quoting_style,
-
- /* Like c_quoting_style except omit the surrounding double-quote
- characters if no quoted characters are encountered.
-
- quotearg_buffer:
- "simple", "\"\\0 \\t\\n'\\\"\\033??/\\\\\"", "a:b"
- quotearg:
- "simple", "\"\\0 \\t\\n'\\\"\\033??/\\\\\"", "a:b"
- quotearg_colon:
- "simple", "\"\\0 \\t\\n'\\\"\\033??/\\\\\"", "\"a:b\""
- */
- c_maybe_quoting_style,
-
- /* Like c_quoting_style except always omit the surrounding
- double-quote characters (ls --quoting-style=escape).
-
- quotearg_buffer:
- "simple", "\\0 \\t\\n'\"\\033??/\\\\", "a:b"
- quotearg:
- "simple", "\\0 \\t\\n'\"\\033??/\\\\", "a:b"
- quotearg_colon:
- "simple", "\\0 \\t\\n'\"\\033??/\\\\", "a\\:b"
- */
- escape_quoting_style,
-
- /* Like clocale_quoting_style, but quote `like this' instead of
- "like this" in the default C locale (ls --quoting-style=locale).
-
- LC_MESSAGES=C
- quotearg_buffer:
- "`simple'", "`\\0 \\t\\n\\'\"\\033??/\\\\'", "`a:b'"
- quotearg:
- "`simple'", "`\\0 \\t\\n\\'\"\\033??/\\\\'", "`a:b'"
- quotearg_colon:
- "`simple'", "`\\0 \\t\\n\\'\"\\033??/\\\\'", "`a\\:b'"
-
- LC_MESSAGES=pt_PT.utf8
- quotearg_buffer:
- "\302\253simple\302\273",
- "\302\253\\0 \\t\\n'\"\\033??/\\\\\302\253", "\302\253a:b\302\273"
- quotearg:
- "\302\253simple\302\273",
- "\302\253\\0 \\t\\n'\"\\033??/\\\\\302\253", "\302\253a:b\302\273"
- quotearg_colon:
- "\302\253simple\302\273",
- "\302\253\\0 \\t\\n'\"\\033??/\\\\\302\253", "\302\253a\\:b\302\273"
- */
- locale_quoting_style,
-
- /* Like c_quoting_style except use quotation marks appropriate for
- the locale (ls --quoting-style=clocale).
-
- LC_MESSAGES=C
- quotearg_buffer:
- "\"simple\"", "\"\\0 \\t\\n'\\\"\\033??/\\\\\"", "\"a:b\""
- quotearg:
- "\"simple\"", "\"\\0 \\t\\n'\\\"\\033??/\\\\\"", "\"a:b\""
- quotearg_colon:
- "\"simple\"", "\"\\0 \\t\\n'\\\"\\033??/\\\\\"", "\"a\\:b\""
-
- LC_MESSAGES=pt_PT.utf8
- quotearg_buffer:
- "\302\253simple\302\273",
- "\302\253\\0 \\t\\n'\"\\033??/\\\\\302\253", "\302\253a:b\302\273"
- quotearg:
- "\302\253simple\302\273",
- "\302\253\\0 \\t\\n'\"\\033??/\\\\\302\253", "\302\253a:b\302\273"
- quotearg_colon:
- "\302\253simple\302\273",
- "\302\253\\0 \\t\\n'\"\\033??/\\\\\302\253", "\302\253a\\:b\302\273"
- */
- clocale_quoting_style
- };
-
-/* Flags for use in set_quoting_flags. */
-enum quoting_flags
- {
- /* Always elide null bytes from styles that do not quote them,
- even when the length of the result is available to the
- caller. */
- QA_ELIDE_NULL_BYTES = 0x01,
-
- /* Omit the surrounding quote characters if no escaped characters
- are encountered. Note that if no other character needs
- escaping, then neither does the escape character. */
- QA_ELIDE_OUTER_QUOTES = 0x02,
-
- /* In the c_quoting_style and c_maybe_quoting_style, split ANSI
- trigraph sequences into concatenated strings (for example,
- "?""?/" rather than "??/", which could be confused with
- "\\"). */
- QA_SPLIT_TRIGRAPHS = 0x04
- };
-
-/* For now, --quoting-style=literal is the default, but this may change. */
-# ifndef DEFAULT_QUOTING_STYLE
-# define DEFAULT_QUOTING_STYLE literal_quoting_style
-# endif
-
-/* Names of quoting styles and their corresponding values. */
-extern char const *const quoting_style_args[];
-extern enum quoting_style const quoting_style_vals[];
-
-struct quoting_options;
-
-/* The functions listed below set and use a hidden variable
- that contains the default quoting style options. */
-
-/* Allocate a new set of quoting options, with contents initially identical
- to O if O is not null, or to the default if O is null.
- It is the caller's responsibility to free the result. */
-struct quoting_options *clone_quoting_options (struct quoting_options *o);
-
-/* Get the value of O's quoting style. If O is null, use the default. */
-enum quoting_style get_quoting_style (struct quoting_options *o);
-
-/* In O (or in the default if O is null),
- set the value of the quoting style to S. */
-void set_quoting_style (struct quoting_options *o, enum quoting_style s);
-
-/* In O (or in the default if O is null),
- set the value of the quoting options for character C to I.
- Return the old value. Currently, the only values defined for I are
- 0 (the default) and 1 (which means to quote the character even if
- it would not otherwise be quoted). */
-int set_char_quoting (struct quoting_options *o, char c, int i);
-
-/* In O (or in the default if O is null),
- set the value of the quoting options flag to I, which can be a
- bitwise combination of enum quoting_flags, or 0 for default
- behavior. Return the old value. */
-int set_quoting_flags (struct quoting_options *o, int i);
-
-/* Place into buffer BUFFER (of size BUFFERSIZE) a quoted version of
- argument ARG (of size ARGSIZE), using O to control quoting.
- If O is null, use the default.
- Terminate the output with a null character, and return the written
- size of the output, not counting the terminating null.
- If BUFFERSIZE is too small to store the output string, return the
- value that would have been returned had BUFFERSIZE been large enough.
- If ARGSIZE is -1, use the string length of the argument for ARGSIZE.
- On output, BUFFER might contain embedded null bytes if ARGSIZE was
- not -1, the style of O does not use backslash escapes, and the
- flags of O do not request elision of null bytes.*/
-size_t quotearg_buffer (char *buffer, size_t buffersize,
- char const *arg, size_t argsize,
- struct quoting_options const *o);
-
-/* Like quotearg_buffer, except return the result in a newly allocated
- buffer. It is the caller's responsibility to free the result. The
- result will not contain embedded null bytes. */
-char *quotearg_alloc (char const *arg, size_t argsize,
- struct quoting_options const *o);
-
-/* Like quotearg_alloc, except that the length of the result,
- excluding the terminating null byte, is stored into SIZE if it is
- non-NULL. The result might contain embedded null bytes if ARGSIZE
- was not -1, SIZE was not NULL, the style of O does not use
- backslash escapes, and the flags of O do not request elision of
- null bytes.*/
-char *quotearg_alloc_mem (char const *arg, size_t argsize,
- size_t *size, struct quoting_options const *o);
-
-/* Use storage slot N to return a quoted version of the string ARG.
- Use the default quoting options.
- The returned value points to static storage that can be
- reused by the next call to this function with the same value of N.
- N must be nonnegative. The output of all functions in the
- quotearg_n family are guaranteed to not contain embedded null
- bytes.*/
-char *quotearg_n (int n, char const *arg);
-
-/* Equivalent to quotearg_n (0, ARG). */
-char *quotearg (char const *arg);
-
-/* Use storage slot N to return a quoted version of the argument ARG
- of size ARGSIZE. This is like quotearg_n (N, ARG), except it can
- quote null bytes. */
-char *quotearg_n_mem (int n, char const *arg, size_t argsize);
-
-/* Equivalent to quotearg_n_mem (0, ARG, ARGSIZE). */
-char *quotearg_mem (char const *arg, size_t argsize);
-
-/* Use style S and storage slot N to return a quoted version of the string ARG.
- This is like quotearg_n (N, ARG), except that it uses S with no other
- options to specify the quoting method. */
-char *quotearg_n_style (int n, enum quoting_style s, char const *arg);
-
-/* Use style S and storage slot N to return a quoted version of the
- argument ARG of size ARGSIZE. This is like quotearg_n_style
- (N, S, ARG), except it can quote null bytes. */
-char *quotearg_n_style_mem (int n, enum quoting_style s,
- char const *arg, size_t argsize);
-
-/* Equivalent to quotearg_n_style (0, S, ARG). */
-char *quotearg_style (enum quoting_style s, char const *arg);
-
-/* Equivalent to quotearg_n_style_mem (0, S, ARG, ARGSIZE). */
-char *quotearg_style_mem (enum quoting_style s,
- char const *arg, size_t argsize);
-
-/* Like quotearg (ARG), except also quote any instances of CH. */
-char *quotearg_char (char const *arg, char ch);
-
-/* Like quotearg_char (ARG, CH), except it can quote null bytes. */
-char *quotearg_char_mem (char const *arg, size_t argsize, char ch);
-
-/* Equivalent to quotearg_char (ARG, ':'). */
-char *quotearg_colon (char const *arg);
-
-/* Like quotearg_colon (ARG), except it can quote null bytes. */
-char *quotearg_colon_mem (char const *arg, size_t argsize);
-
-/* Free any dynamically allocated memory. */
-void quotearg_free (void);
-
-#endif /* !QUOTEARG_H_ */