--- parser3/src/include/pa_table.h	2001/03/29 20:53:03	1.27
+++ parser3/src/include/pa_table.h	2003/04/11 15:00:05	1.49
@@ -1,21 +1,19 @@
 /** @file
 	Parser: table class decl.
 
-	Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)
-
-	Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)
-
-	$Id: pa_table.h,v 1.27 2001/03/29 20:53:03 paf Exp $
+	Copyright (c) 2001, 2003 ArtLebedev Group (http://www.artlebedev.com)
+	Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
 */
 
 #ifndef PA_TABLE_H
 #define PA_TABLE_H
 
+static const char* IDENT_TABLE_H="$Date: 2003/04/11 15:00:05 $";
+
 #include "pa_types.h"
 #include "pa_array.h"
 #include "pa_hash.h"
 #include "pa_string.h"
-#include "pa_request.h"
 
 /** 
 	VTable backend.
@@ -27,42 +25,62 @@
 
 	uses String for column names and data items
 
-	hence most of tables are "named", no need to uptimize nameless onces
+	hence most of tables are "named", no need to uptimize nameless onces.
+	rows and strings stored are read-only. once stored they can be removed,
+	but not altered. that's handy for quick copying & co. see table:join
 */
 class Table : public Array {
 public:
+	struct Action_options {
+	     int offset;
+	     int limit; //< negative limit means 'all'. zero limit means 'nothing'
+	     bool reverse;
+	     bool defined;
+
+	     Action_options(): offset(0), limit(-1), reverse(false), defined(false) {}
+	};
 
 	Table(Pool& apool,
 		const String *aorigin,
-		Array *acolumns,
+		const Array *acolumns,
 		int initial_rows=CR_INITIAL_ROWS_DEFAULT);
+	Table(Pool& apool, const Table& source, Action_options& options);
 
 	/// where this table came from, may be NULL
 	const String *origin_string() { return forigin_string; }
 
-	/// column names
+	/// gets column names
 	const Array *columns() { return fcolumns; }
 
+	/// assignes column names
+	void set_columns(const Array *acolumns) { fcolumns=acolumns; }
+
 	/// moves @a current pointer
-	void set_current(int acurrent) { fcurrent=acurrent; }
-	/// @return current pointer
-	int current() { return fcurrent; }
-	void shift(int offset);
+	void set_current(int acurrent);	/// @return current pointer
+	int current() const { return fcurrent; }
+	void offset(bool absolute, int offset);
+
+	/** @return column index from @a column_name. '<0' if no such column
+		if no such colum conditionally 'bark'
+	*/
+	int column_name2index(const String& column, bool bark) const;
 
 	/// @return item from @a column
 	const String *item(int column) const;
-	/// @return item from @a column
-	const String *item(const String& column) const { 
-		return item(column_name2index(column)); 
+
+	/// @return item from @a column. '0' if no such column
+	const String *item(const String& column) const {
+		int index=column_name2index(column, false);
+		return index>=0?item(index):0;
 	}
 
 	/// saves to text file
 	void save(bool nameless_save, const String& file_spec);
 
-	bool locate(int column, const String& value);
-	bool locate(const String& column, const String& value) {
-		return locate(column_name2index(column), value);
-	}
+	typedef bool (*locate_func)(Table& self, void* info);
+	bool locate(locate_func func, void* info, Action_options& options);
+	bool locate(int column, const String& value, Action_options& options);
+	bool locate(const String& column, const String& value, Action_options& options);
 
 	const Array& at(int index) const {
 		// force @c const result
@@ -75,20 +93,16 @@ private:
 	const String *forigin_string;
 
 	// column name->number lookup table
-	Hash name2number;
+	Hash& name2number;
 
 	// current row
 	int fcurrent;
 
 	// columns
-	Array *fcolumns;
+	const Array *fcolumns;
 
 	bool valid(int index) const { return index>=0 && index<size(); }
 
-	/// @return column index from @a column_name
-	int column_name2index(const String& column) const;
-
-
 };
 
 #endif