--- parser3/src/include/pa_table.h	2001/03/28 08:01:41	1.24
+++ parser3/src/include/pa_table.h	2024/12/11 15:46:38	1.78
@@ -1,21 +1,20 @@
 /** @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.24 2001/03/28 08:01:41 paf Exp $
+	Copyright (c) 2001-2024 Art. Lebedev Studio (http://www.artlebedev.com)
+	Authors: Konstantin Morshnev <moko@design.ru>, Alexandr Petrosian <paf@design.ru>
 */
 
 #ifndef PA_TABLE_H
 #define PA_TABLE_H
 
+#define IDENT_PA_TABLE_H "$Id: pa_table.h,v 1.78 2024/12/11 15:46:38 moko Exp $"
+
 #include "pa_types.h"
-#include "pa_array.h"
 #include "pa_hash.h"
 #include "pa_string.h"
-#include "pa_request.h"
+
+class Temp_current;
 
 /** 
 	VTable backend.
@@ -27,63 +26,138 @@
 
 	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 {
+class Table: public Array<ArrayString*> {
 public:
+	typedef ArrayString* columns_type;
 
-	Table(Pool& apool,
-		const String *aorigin,
-		Array *acolumns,
-		int initial_rows=CR_INITIAL_ROWS_DEFAULT);
+	Table(columns_type acolumns, size_t initial_rows=3);
+	Table(const Table& src, Action_options& options);
 
-	/// where this table came from, may be NULL
-	const String *origin_string() { return forigin_string; }
+	/// gets column names
+	columns_type columns() { return fcolumns; }
 
-	/// 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; }
+	size_t current() const { return fcurrent; }
+
+	/// sets @a current pointer, can be out of range when restoring current in modified table
+	void set_current(size_t acurrent) {
+		fcurrent=acurrent<count() ? acurrent : count()>0 ? count()-1 : 0;
+	}
+
+	/// sets or offsets @a current pointer, wrapping within the table
+	void offset(bool absolute, int offset);
+
+	/// is that @c index falid?
+	bool valid(size_t index) const { return index<count(); }
+
+	/// @return checks all rows to find maximum cells number
+	size_t max_cells() const;
+
+	/** @return column index from @a column_name. '<0' if no such column
+		if no such - 'bark'
+	*/
+	int column_name2index(const String& column, bool bark) const;
+
+	void column_names_init();
+
+	/// @return item from @a column
+	const String* item(size_t column);
 
-	/// @return item from @a column_name
-	const String *item(const String& column) const { 
-		return item(column_name2index(column)); 
+	/// sets @a column value
+	void put_item(size_t column, const String*);
+
+	/// removes current row
+	void remove_current();
+
+	/// @return item from @a column. '0' if no such column
+	const String* item(const String& column) {
+		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(const String& column, const String& value) const;
+	template<typename I>
+	void table_for_each(void (*func)(Table& self, I* info), I* info, Action_options& o);
 
-private:
-	
-	// where this table came from, may be NULL
-	const String *forigin_string;
+	template<typename I>
+	bool table_first_that(bool (*func)(Table& self, I info), I info, Action_options& o) {
+		if(!o.adjust(count()))
+			return false;
+
+		size_t saved_current=current();
+		size_t row=o.offset;
+		if(o.reverse) { // reverse
+			for(size_t i=0; i<o.limit; i++) {
+				set_current(row-i);
+
+				if(func(*this, info))
+					return true;
+			}
+		} else { // forward
+			for(size_t to=row+o.limit; row<to; row++) {
+				set_current(row);
+
+				if(func(*this, info))
+					return true;
+			}
+		}
 
-	// column name->number lookup table
-	Hash name2number;
+		set_current(saved_current);
+		return false;
+	}
 
-	// current row
-	int fcurrent;
+	bool locate(int column, const String& value, Action_options& options);
+	bool locate(const String& column, const String& value, Action_options& options);
 
-	// columns
-	Array *fcolumns;
+private:
+	
+	/// current row
+	size_t fcurrent;
 
-	bool valid(int index) const { return index>=0 && index<size(); }
+	/// columns
+	columns_type fcolumns;
 
-	const Array& at(int index) const {
-		// force @c const result
-		return *const_cast<const Array *>(static_cast<Array *>(get(index)));
-	}
+	/// column name->number lookup table
+	typedef HashString<int> name2number_hash_class;
+	name2number_hash_class* name2number;
 
-	/// @return column index from @a column_name
-	int column_name2index(const String& column_name) const;
 
-	const String *item(int column_index) const;
+};
 
+/// Auto-object that temporarily saves and restores current
+class Temp_current {
+	Table& ftable;
+	size_t fcurrent;
+public:
+	Temp_current(Table& atable) : ftable(atable), fcurrent(atable.current()){}
+	~Temp_current(){
+		ftable.set_current(fcurrent);
+	}
 };
 
+template<typename I> void Table::table_for_each(void (*func)(Table& self, I* info), I* info, Action_options& o) {
+	if(!o.adjust(count()))
+		return;
+
+	Temp_current tc(*this);
+	size_t row=o.offset;
+	if(o.reverse) { // reverse
+		for(size_t i=0; i<o.limit; i++) {
+			set_current(row-i);
+			func(*this, info);
+		}
+	} else { // forward
+		for(size_t to=row+o.limit; row<to; row++) {
+			set_current(row);
+			func(*this, info);
+		}
+	}
+}
+
 #endif