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.3 and 1.68

-version 1.3, 2001/01/29 20:46:22
+version 1.68, 2015/09/22 23:46:22
  Line 1
- /*
+ /** @file
-   $Id$
+         Parser: table class decl.
- */
- /*
+         Copyright (c) 2001-2012 Art. Lebedev Studio (http://www.artlebedev.com)
-         hence most of tables are "named", no need to uptimize unnamed onces
+         Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
  */
  #ifndef PA_TABLE_H
  #define PA_TABLE_H
+ #define IDENT_PA_TABLE_H "$Id$"
  #include "pa_types.h"
- #include "pa_array.h"
  #include "pa_hash.h"
  #include "pa_string.h"
- #include "pa_request.h"
- class Table : public Array {
- public:
-         // request I'm processed on
-         Request& request;
-         // the base origin of table data
+ /**
-         Origin origin;
+         VTable backend.
-         int current;
+         holds:
+         - column names[if any]
-         // columns
+         - data rows
-         Array *columns;
+         - current row pointer
-         Table(Request& request,
+         uses String for column names and data items
-                 char *afile, uint aline,
-                 Array *acolumns,
+         hence most of tables are "named", no need to uptimize nameless onces.
-                 int initial_rows=CR_INITIAL_ROWS_DEFAULT);
+         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
-         const char *item(int column_index);
+ */
-         const char *item(String column_name);
+ class Table: public Array<ArrayString*> {
+ public:
- protected:
+         typedef ArrayString* columns_type;
-         // column name->number lookup table
+         Table(
-         Hash name2number;
+                 columns_type acolumns,
+                 size_t initial_rows=3);
+         Table(const Table& src, Action_options& options);
+         /// gets column names
+         columns_type columns() { return fcolumns; }
+         /// moves @a current pointer
+         void set_current(size_t acurrent) {
+                 assert(acurrent==0 || acurrent<count());
+                 fcurrent=acurrent;
+         }
+         /// @return current pointer
+         size_t current() const { return fcurrent; }
+         void offset(bool absolute, int offset);
+         /// @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;
+         /// @return item from @a column
+         const String* item(size_t 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);
+         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 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);
+                         }
+                 }
+                 set_current(saved_current);
+         }
+         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;
+                         }
+                 }
+                 set_current(saved_current);
+                 return false;
+         }
+         bool locate(int column, const String& value, Action_options& options);
+         bool locate(const String& column, const String& value, Action_options& options);
+ private:
+         /// current row
+         size_t fcurrent;
+         /// columns
+         columns_type fcolumns;
+         /// column name->number lookup table
+         typedef HashString<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(); }
  };

E-mail:

Removed from v.1.3
changed lines
	Added in v.1.68