--- parser3/src/include/pa_table.h	2001/01/29 22:34:57	1.5
+++ parser3/src/include/pa_table.h	2001/03/19 15:29:38	1.14
@@ -1,12 +1,11 @@
-/*
-  $Id: pa_table.h,v 1.5 2001/01/29 22:34:57 paf Exp $
-*/
+/** @file
+	Parser
+	Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)
+	Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)
 
-/*
-	hence most of tables are "named", no need to uptimize unnamed onces
+	$Id: pa_table.h,v 1.14 2001/03/19 15:29:38 paf Exp $
 */
 
-
 #ifndef PA_TABLE_H
 #define PA_TABLE_H
 
@@ -16,34 +15,43 @@
 #include "pa_string.h"
 #include "pa_request.h"
 
+/// parser \b table class 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
+*/
 class Table : public Array {
 public:
 
-	Table(Request& request,
-		char *afile, uint aline,
+	Table(Pool& apool,
+		const String& asource,
 		Array *acolumns,
 		int initial_rows=CR_INITIAL_ROWS_DEFAULT);
 
-	// the base origin of table's data
-	//const Origin& origin() { return forigin; }
+	/// the string source of table's data
+	//const String& source() { return fsource; }
 
+	/// column names
 	const Array *columns() { return fcolumns; }
 
+	/// moves \a current pointer
 	void set_current(int acurrent) { fcurrent=acurrent; }
+	/// \return current pointer
 	int get_current() { return fcurrent; }
-	void inc_current() { fcurrent++; }
-
-	void read_item(String& result, const String& column_name) {
-		result.APPEND(item(column_name), forigin.file, forigin.line+fcurrent);
-	}
 
-protected:
+	/// \return item from \a column_name
+	const String *item(const String& column_name);
 
-	// request I'm processed on
-	Request& request;
+private:
 
 	// the base origin of table's data
-	Origin forigin;
+	const String& fsource;
 
 	// column name->number lookup table
 	Hash name2number;
@@ -54,10 +62,13 @@ protected:
 	// columns
 	Array *fcolumns;
 
-	const Array *at(int index);
+	bool valid(int index) { return index>=0 && index<size();	}
 
-	const char *item(int column_index);
-	const char *item(const String& column_name);
+	const Array& at(int index);
+
+	const String *item(int column_index) {
+		return valid(fcurrent)?at(fcurrent).get_string(column_index):0;
+	}
 };
 
 #endif