Name
Shell-related Utilities --
Details
enum GShellError
typedef enum
{
/* mismatched or otherwise mangled quoting */
G_SHELL_ERROR_BAD_QUOTING,
/* string to be parsed was empty */
G_SHELL_ERROR_EMPTY_STRING,
G_SHELL_ERROR_FAILED
} GShellError; |
G_SHELL_ERROR
#define G_SHELL_ERROR g_shell_error_quark () |
g_shell_parse_argv ()
Parses a command line into an argument vector, in much the same way
the shell would, but without many of the expansions the shell would
perform (variable expansion, globs, operators, filename expansion,
etc. are not supported). The results are defined to be the same as
those you would get from a UNIX98 /bin/sh, as long as the input
contains none of the unsupported shell expansions. If the input
does contain such expansions, they are passed through
literally. Possible errors are those from the G_SHELL_ERROR
domain.
g_shell_quote ()
gchar* g_shell_quote (const gchar *unquoted_string); |
Quotes a string so that the shell (/bin/sh) will interpret the
quoted string to mean unquoted_string. If you pass a filename to
the shell, for example, you should first quote it with this
function. The return value must be freed with g_free(). The
quoting style used is undefined (single or double quotes may be
used).
g_shell_unquote ()
Unquotes a string as the shell (/bin/sh) would. Only handles
quotes; if a string contains file globs, arithmetic operators,
variables, backticks, redirections, or other special-to-the-shell
features, the result will be different from the result a real shell
would produce (the variables, backticks, etc. will be passed
through literally instead of being expanded). This function is
guaranteed to succeed if applied to the result of
g_shell_quote(). If it fails, it returns NULL and sets the
error. The quoted_string need not actually contain quoted or
escaped text; g_shell_unquote() simply goes through the string and
unquotes/unescapes anything that the shell would. Both single and
double quotes are handled, as are escapes including escaped
newlines. The return value must be freed with g_free(). Possible
errors are in the G_SHELL_ERROR domain.