parser3/src/include/pa_table.h - diff

Return to pa_table.h CVS log

Up to [parser3project] / parser3 / src / include

Diff for /parser3/src/include/pa_table.h between versions 1.13 and 1.61

-version 1.13, 2001/03/12 20:55:15
+version 1.61, 2006/11/02 12:07:25
  Line 1
- /*
+ /** @file
-         Parser
+         Parser: table class decl.
-         Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)
-         Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)
-         $Id$
+         Copyright (c) 2001-2005 ArtLebedev Group (http://www.artlebedev.com)
+         Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
  */
- /*
-         hence most of tables are "named", no need to uptimize nameless onces
- */
  #ifndef PA_TABLE_H
  #define PA_TABLE_H
+ static const char * const IDENT_TABLE_H="$Date$";
  #include "pa_types.h"
- #include "pa_array.h"
  #include "pa_hash.h"
  #include "pa_string.h"
- #include "pa_request.h"
- class Table : public Array {
+ /**
+         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<ArrayString*> {
  public:
+         typedef ArrayString* columns_type;
-         Table(Pool& apool,
+         Table(
-                 const String& asource,
+                 columns_type acolumns,
-                 Array *acolumns,
+                 size_t initial_rows=3);
-                 int initial_rows=CR_INITIAL_ROWS_DEFAULT);
+         Table(const Table& src, Action_options& options);
-         // the source of table's data
+         /// gets column names
-         const String& source() { return fsource; }
+         columns_type columns() { return fcolumns; }
-         const Array *columns() { return fcolumns; }
+         /// moves @a current pointer
+         void set_current(size_t acurrent) {
+                 assert(acurrent==0 || acurrent<count());
-         void set_current(int acurrent) { fcurrent=acurrent; }
+                 fcurrent=acurrent;
-         int get_current() { return fcurrent; }
+         }
+         /// @return current pointer
+         size_t 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 - 'bark'
+         */
+         int column_name2index(const String& column, bool bark) const;
+         /// @return item from @a column
+         const String* item(size_t column);
+         /// @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;
+         }
-         const String *item(const String& column_name);
+         /// saves to text file
+         void save(bool nameless_save, const String& file_spec);
- private:
+         template<typename I>
+         void table_for_each(void (*func)(Table& self, I* info), I* info, Action_options& o) {
+                 if(!o.adjust(count()))
+                         return;
+                 size_t saved_current=current();
+                 size_t row=o.offset;
+                 if(o.reverse) { // reverse
+                         for(size_t to=row-o.limit; row>=to; --row) {
+                                 set_current(row);
+                                 func(*this, info);
+                         }
+                 } else { // forward
+                         for(size_t to=row+o.limit; row<to; row++) {
+                                 set_current(row);
+                                 func(*this, info);
+                         }
+                 }
+                 set_current(saved_current);
+         }
-         // the base origin of table's data
+         template<typename I>
-         const String& fsource;
+         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(o.offset-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;
+                         }
+                 }
+                 set_current(saved_current);
-         // column name->number lookup table
+                 return false;
-         Hash name2number;
+         }
-         // current row
-         int fcurrent;
-         // columns
+         bool locate(int column, const String& value, Action_options& options);
-         Array *fcolumns;
+         bool locate(const String& column, const String& value, Action_options& options);
-         bool valid(int index) { return index>=0 && index<size();        }
+ private:
+         /// current row
+         size_t fcurrent;
+         /// columns
+         columns_type fcolumns;
+         /// column name->number lookup table
+         typedef Hash<const String::Body, int> name2number_hash_class;
+         name2number_hash_class* name2number;
-         const Array& at(int index);
+         /// is that @c index falid?
+         bool valid(size_t index) const { return index<count(); }
-         const String *item(int column_index) {
-                 return valid(fcurrent)?at(fcurrent).get_string(column_index):0;
-         }
  };
  #endif

E-mail:

Removed from v.1.13
changed lines
	Added in v.1.61