postgresql/src/bin/psql/stringutils.h

/*
 * psql - the PostgreSQL interactive terminal
 *
 * Copyright (c) 2000-2017, PostgreSQL Global Development Group
 *
 * src/bin/psql/stringutils.h
 */
#ifndef STRINGUTILS_H
#define STRINGUTILS_H

/* The cooler version of strtok() which knows about quotes and doesn't
 * overwrite your input */
extern char *strtokx(const char *s,
		const char *whitespace,
		const char *delim,
		const char *quote,
		char escape,
		bool e_strings,
		bool del_quotes,
		int encoding);

extern void strip_quotes(char *source, char quote, char escape, int encoding);

extern char *quote_if_needed(const char *source, const char *entails_quote,
				char quote, char escape, int encoding);

#endif   /* STRINGUTILS_H */
another set of cleanups 2000-01-19 00:30:24 +01:00			`/*`
			`* psql - the PostgreSQL interactive terminal`
			`*`
Update copyright via script for 2017 2017-01-03 19:48:53 +01:00			`* Copyright (c) 2000-2017, PostgreSQL Global Development Group`
another set of cleanups 2000-01-19 00:30:24 +01:00			`*`
Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00			`* src/bin/psql/stringutils.h`
another set of cleanups 2000-01-19 00:30:24 +01:00			`*/`
Postgres95 1.01 Distribution - Virgin Sources 1996-07-09 08:22:35 +02:00			`#ifndef STRINGUTILS_H`
			`#define STRINGUTILS_H`

Major psql overhaul by Peter Eisentraut. 1999-11-04 22:56:02 +01:00			`/* The cooler version of strtok() which knows about quotes and doesn't`
			`* overwrite your input */`
psql cleanup 1999-11-05 00:14:30 +01:00			`extern char strtokx(const char s,`
Fix psql's \copy to accept table names containing schemas, as well as a column list. Bring its parsing of quoted names and quoted strings somewhat up to speed --- I believe it now handles all non-error cases the same way the backend would, but weird boundary conditions are not necessarily done the same way. 2002-10-19 02:22:14 +02:00			`const char *whitespace,`
psql cleanup 1999-11-05 00:14:30 +01:00			`const char *delim,`
			`const char *quote,`
Fix psql's \copy to accept table names containing schemas, as well as a column list. Bring its parsing of quoted names and quoted strings somewhat up to speed --- I believe it now handles all non-error cases the same way the backend would, but weird boundary conditions are not necessarily done the same way. 2002-10-19 02:22:14 +02:00			`char escape,`
Respond to Jeremy Drake's original gripe that \copy needs to recognize E'...' syntax for strings in order to track the backend. 2006-06-01 03:28:00 +02:00			`bool e_strings,`
Fix psql's \copy to accept table names containing schemas, as well as a column list. Bring its parsing of quoted names and quoted strings somewhat up to speed --- I believe it now handles all non-error cases the same way the backend would, but weird boundary conditions are not necessarily done the same way. 2002-10-19 02:22:14 +02:00			`bool del_quotes,`
Adapt to the changes of libpq(eliminateing using putenv()). 2000-01-15 06:38:50 +01:00			`int encoding);`
Another pgindent run. Fixes enum indenting, and improves #endif spacing. Also adds space for one-line comments. 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);`

psql: when tab-completing, use quotes on file names that need them psql backslash commands that deal with file or directory names require quotes around those that have spaces, single quotes, or backslashes. However, tab-completing such names does not provide said quotes, and is thus almost useless with them. This patch fixes the problem by having a wrapper function around rl_filename_completion_function that dequotes on input and quotes on output. This eases dealing with such names. Author: Noah Misch 2012-02-28 05:06:29 +01:00			`extern char quote_if_needed(const char source, const char *entails_quote,`
			`char quote, char escape, int encoding);`

New pgindent run with fixes suggested by Tom. Patch manually reviewed, initdb/regression tests pass. 2001-11-05 18:46:40 +01:00			`#endif /* STRINGUTILS_H */`