aboutsummaryrefslogtreecommitdiff
path: root/src/interfaces/libpq++/pgdatabase.h
blob: e1e3c34f6194149d2f15b5857c8b06e4fc1405b3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
/*-------------------------------------------------------------------------
*
* pgdatabase.h
*
*
*	DESCRIPTION
*		Postgres Database Class:
*		   Query Postgres backend to obtain query results
*
*	NOTES
*	   Currently under construction.
*
* Portions Copyright (c) 1996-2002, PostgreSQL Global Development Group
* Portions Copyright (c) 1994, Regents of the University of California
*
*
*  $Id: pgdatabase.h,v 1.14 2002/07/02 16:32:19 momjian Exp $
*
*-------------------------------------------------------------------------
*/

#ifndef PGDATABASE_H
#define PGDATABASE_H

#ifndef PGCONNECTION_H
#include "pgconnection.h"
#endif

// ****************************************************************
//
// PgDatabase - a class for accessing databases
//
// ****************************************************************
// This is the basic database access class.  Its interface should
// be used only after a query has been sent to the backend and
// results are being received.
class DLLIMPORT PgDatabase : public PgConnection
{
public:
	// connect to the database with conninfo
	explicit PgDatabase(const char* conninfo) : PgConnection(conninfo)
	{}

	~PgDatabase()
	{}				// close connection and clean up


	typedef int size_type;

	// query result access
	size_type Tuples() const;
	size_type CmdTuples() const;
	int Fields();
	const char* FieldName(int field_num) const;
	int FieldNum(const char* field_name) const;
	Oid FieldType(int field_num) const;
	Oid FieldType(const char* field_name) const;
	int FieldSize(int field_num) const;
	int FieldSize(const char* field_name) const;
	const char* GetValue(size_type tup_num, int field_num) const;
	const char* GetValue(size_type tup_num, const char* field_name) const;
	bool GetIsNull(size_type tup_num, int field_num) const;
	bool GetIsNull(size_type tup_num, const char* field_name) const;
	int GetLength(size_type tup_num, int field_num) const;
	int GetLength(size_type tup_num, const char* field_name) const;

	// OBSOLESCENT (use PQprint()):
	void DisplayTuples(FILE *out = 0, bool fillAlign = true,
					   const char* fieldSep = "|", bool printHeader = true, bool quiet = false) const;
	void PrintTuples(FILE *out = 0, bool printAttName = true,
					 bool terseOutput = false, bool fillAlign = false) const;

	// copy command related access
	int GetLine(char str[], int length);
	void PutLine(const char str[]);
	const char* OidStatus() const;
	int EndCopy();

protected:
	PgDatabase() : PgConnection()
	{}	// Do not connect


private:
	// We don't support copying of PgDatabase objects,
	// so make copy constructor and assignment op private.
	PgDatabase(const PgDatabase&);
	PgDatabase& operator= (const PgDatabase&);
};

#endif	// PGDATABASE_H