Manual Reference Pages - QUOTE (3)
quotestrdup, quoterunestrdup, unquotestrdup, unquoterunestrdup, quotestrfmt, quoterunestrfmt, quotefmtinstall, doquote, needsrcquote - quoted character strings
char *quotestrdup(char *s)
Rune *quoterunestrdup(Rune *s)
char *unquotestrdup(char *s)
Rune *unquoterunestrdup(Rune *s)
int (*doquote)(int c)
int needsrcquote(int c)
These routines manipulate character strings, either adding or removing
quotes as necessary.
In the quoted form, the strings are in the style of
with single quotes surrounding the string.
Embedded single quotes are indicated by a doubled single quote.
The function pointer
nil by default.
If it is non-nil, characters are passed to that function to see if they should
This mechanism allows programs to specify that
characters other than blanks, control characters, or quotes be quoted.
Regardless of the return value of
*doquote, blanks, control characters, and quotes are always quoted.
Needsrcquote is provided as a
doquote function that flags any character special to
when quoted becomes
The empty string is represented by two quotes,
The first four functions act as variants of
Each returns a
freshly allocated copy of the string, created using
Quotestrdup returns a quoted copy of
unquotestrdup returns a copy of
s with the quotes evaluated.
rune versions of these functions do the same for
The string returned by
quoterunestrdup has the following properties:
If the original string
s is empty, the returned string is
s contains no quotes, blanks, or control characters,
the returned string is identical to
s needs quotes to be added, the first character of the returned
string will be a quote.
hello world becomes
hello world not
formatting routines that produce quoted strings as output.
They may be installed by hand, but
quotefmtinstall installs them under the standard format characters
Q. (They are not installed automatically.)
If the format string includes the alternate format character
#, for example
%#q, the printed string will always be quoted; otherwise quotes will only be provided if necessary
to avoid ambiguity.
<libc.h> there are
#pragma statements so the compiler can type-check uses of
Because it is provided by the format library,
doquote is a preprocessor macro defined as
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.