2000-01-19 00:30:24 +01:00
|
|
|
/*
|
|
|
|
|
* psql - the PostgreSQL interactive terminal
|
|
|
|
|
*
|
2024-01-04 02:49:05 +01:00
|
|
|
* Copyright (c) 2000-2024, PostgreSQL Global Development Group
|
2000-01-19 00:30:24 +01:00
|
|
|
*
|
2010-09-20 22:08:53 +02:00
|
|
|
* src/bin/psql/stringutils.h
|
2000-01-19 00:30:24 +01:00
|
|
|
*/
|
1996-07-09 08:22:35 +02:00
|
|
|
#ifndef STRINGUTILS_H
|
|
|
|
|
#define STRINGUTILS_H
|
|
|
|
|
|
1999-11-04 22:56:02 +01:00
|
|
|
/* The cooler version of strtok() which knows about quotes and doesn't
|
|
|
|
|
* overwrite your input */
|
1999-11-05 00:14:30 +01:00
|
|
|
extern char *strtokx(const char *s,
|
2002-10-19 02:22:14 +02:00
|
|
|
const char *whitespace,
|
1999-11-05 00:14:30 +01:00
|
|
|
const char *delim,
|
|
|
|
|
const char *quote,
|
2002-10-19 02:22:14 +02:00
|
|
|
char escape,
|
2006-06-01 03:28:00 +02:00
|
|
|
bool e_strings,
|
2002-10-19 02:22:14 +02:00
|
|
|
bool del_quotes,
|
2000-01-15 06:38:50 +01:00
|
|
|
int encoding);
|
2001-10-28 07:26:15 +01:00
|
|
|
|
Add support for piping COPY to/from an external program.
This includes backend "COPY TO/FROM PROGRAM '...'" syntax, and corresponding
psql \copy syntax. Like with reading/writing files, the backend version is
superuser-only, and in the psql version, the program is run in the client.
In the passing, the psql \copy STDIN/STDOUT syntax is subtly changed: if you
the stdin/stdout is quoted, it's now interpreted as a filename. For example,
"\copy foo from 'stdin'" now reads from a file called 'stdin', not from
standard input. Before this, there was no way to specify a filename called
stdin, stdout, pstdin or pstdout.
This creates a new function in pgport, wait_result_to_str(), which can
be used to convert the exit status of a process, as returned by wait(3),
to a human-readable string.
Etsuro Fujita, reviewed by Amit Kapila.
2013-02-27 17:17:21 +01:00
|
|
|
extern void strip_quotes(char *source, char quote, char escape, int encoding);
|
|
|
|
|
|
2012-02-28 05:06:29 +01:00
|
|
|
extern char *quote_if_needed(const char *source, const char *entails_quote,
|
Improve psql's tab completion for filenames.
The Readline library contains a fair amount of knowledge about how to
tab-complete filenames, but it turns out that that doesn't work too well
unless we follow its expectation that we use its filename quoting hooks
to quote and de-quote filenames. We were trying to do such quote handling
within complete_from_files(), and that's still what we have to do if we're
using libedit, which lacks those hooks. But for Readline, it works a lot
better if we tell Readline that single-quote is a quoting character and
then provide hooks that know the details of the quoting rules for SQL
and psql meta-commands.
Hence, resurrect the quoting hook functions that existed in the original
version of tab-complete.c (and were disabled by commit f6689a328 because
they "didn't work so well yet"), and whack on them until they do seem to
work well.
Notably, this fixes bug #16059 from Steven Winfield, who pointed out
that the previous coding would strip quote marks from filenames in SQL
COPY commands, even though they're syntactically necessary there.
Now, we not only don't do that, but we'll add a quote mark when you
tab-complete, even if you didn't type one.
Getting this to work across a range of libedit versions (and, to a
lesser extent, libreadline versions) was depressingly difficult.
It will be interesting to see whether the new regression test cases
pass everywhere in the buildfarm.
Some future patch might try to handle quoted SQL identifiers with
similar explicit quoting/dequoting logic, but that's for another day.
Patch by me, reviewed by Peter Eisentraut.
Discussion: https://postgr.es/m/16059-8836946734c02b84@postgresql.org
2020-01-23 17:07:12 +01:00
|
|
|
char quote, char escape, bool force_quote,
|
|
|
|
|
int encoding);
|
2012-02-28 05:06:29 +01:00
|
|
|
|
1996-07-09 08:22:35 +02:00
|
|
|
#endif /* STRINGUTILS_H */
|
