--- parser3/src/include/pa_table.h	2001/03/12 20:55:15	1.13
+++ parser3/src/include/pa_table.h	2001/09/26 10:32:25	1.35
@@ -1,47 +1,84 @@
-/*
-	Parser
+/** @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.13 2001/03/12 20:55:15 paf Exp $
-*/
-
-/*
-	hence most of tables are "named", no need to uptimize nameless onces
+	$Id: pa_table.h,v 1.35 2001/09/26 10:32:25 parser Exp $
 */
 
-
 #ifndef PA_TABLE_H
 #define PA_TABLE_H
 
+#include "pa_config_includes.h"
 #include "pa_types.h"
 #include "pa_array.h"
 #include "pa_hash.h"
 #include "pa_string.h"
-#include "pa_request.h"
 
+/** 
+	VTable backend.
+
+	holds:
+	- column names[if any]
+	- data rows
+	- current row pointer
+
+	uses String for column names and data items
+
+	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:
 
 	Table(Pool& apool,
-		const String& asource,
-		Array *acolumns,
+		const String *aorigin,
+		const Array *acolumns,
 		int initial_rows=CR_INITIAL_ROWS_DEFAULT);
 
-	// the source of table's data
-	const String& source() { return fsource; }
+	/// where this table came from, may be NULL
+	const String *origin_string() { return forigin_string; }
 
+	/// column names
 	const Array *columns() { return fcolumns; }
 
+	/// moves @a current pointer
 	void set_current(int acurrent) { fcurrent=acurrent; }
-	int get_current() { return fcurrent; }
+	/// @return current pointer
+	int current() { return fcurrent; }
+	void shift(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. '0' if no such column
+	const String *item(const String& column) const {
+		int index=column_name2index(column, false);
+		return index>=0?item(index):0;
+	}
 
-	const String *item(const String& column_name);
+	/// saves to text file
+	void save(bool nameless_save, const String& file_spec);
 
-private:
+	bool locate(int column, const String& value);
+	bool locate(const String& column, const String& value);
+
+	const Array& at(int index) const {
+		// force @c const result
+		return *const_cast<const Array *>(static_cast<Array *>(get(index)));
+	}
 
-	// the base origin of table's data
-	const String& fsource;
+private:
+	
+	// where this table came from, may be NULL
+	const String *forigin_string;
 
 	// column name->number lookup table
 	Hash name2number;
@@ -50,15 +87,10 @@ private:
 	int fcurrent;
 
 	// columns
-	Array *fcolumns;
-
-	bool valid(int index) { return index>=0 && index<size();	}
+	const Array *fcolumns;
 
-	const Array& at(int index);
+	bool valid(int index) const { return index>=0 && index<size(); }
 
-	const String *item(int column_index) {
-		return valid(fcurrent)?at(fcurrent).get_string(column_index):0;
-	}
 };
 
 #endif