Diff for /parser3/src/include/pa_table.h between versions 1.25 and 1.48.2.11.2.9

version 1.25, 2001/03/28 09:01:21 version 1.48.2.11.2.9, 2003/04/14 11:23:41
Line 1 Line 1
 /** @file  /** @file
         Parser: table class decl.          Parser: table class decl.
   
         Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)          Copyright (c) 2001-2003 ArtLebedev Group (http://www.artlebedev.com)
           Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
         Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)  
   
         $Id$  
 */  */
   
 #ifndef PA_TABLE_H  #ifndef PA_TABLE_H
 #define PA_TABLE_H  #define PA_TABLE_H
   
   static const char* IDENT_TABLE_H="$Date$";
   
 #include "pa_types.h"  #include "pa_types.h"
 #include "pa_array.h"  
 #include "pa_hash.h"  #include "pa_hash.h"
 #include "pa_string.h"  #include "pa_string.h"
 #include "pa_request.h"  
   
 /**   /** 
         VTable backend.          VTable backend.
Line 27 Line 24
   
         uses String for column names and data items          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:  public:
           typedef ArrayString* columns_type;
   
         Table(Pool& apool,          struct Action_options {
                 const String *aorigin,               size_t offset;
                 Array *acolumns,               size_t limit; //< negative limit means 'all'. zero limit means 'nothing'
                 int initial_rows=CR_INITIAL_ROWS_DEFAULT);               bool reverse;
                bool defined;
         /// where this table came from, may be NULL  
         const String *origin_string() { return forigin_string; }               Action_options(): 
                   offset(0), limit(ARRAY_OPTION_LIMIT_ALL), reverse(false), 
                   defined(false) {}
           };
   
           Table(
                   columns_type acolumns,
                   size_t initial_rows=3);
           Table(const Table& src, Action_options& options);
   
         /// column names          /// gets column names
         const Array *columns() { return fcolumns; }          columns_type columns() { return fcolumns; }
   
         /// moves @a current pointer          /// moves @a current pointer
         void set_current(int acurrent) { fcurrent=acurrent; }          void set_current(size_t acurrent) {
                   assert(acurrent<count());
   
                   fcurrent=acurrent;
           }
         /// @return current pointer          /// @return current pointer
         int current() { return fcurrent; }          size_t current() const { return fcurrent; }
         void shift(int offset);          void offset(bool absolute, int offset);
   
         /// @return item from @a column_name          /** @return column index from @a column_name. '<0' if no such column
         const String *item(const String& column) const {                   if no such - 'bark'
                 return item(column_name2index(column));           */
           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;
         }          }
   
         /// saves to text file          /// saves to text file
         void save(bool nameless_save, const String& file_spec);          void save(bool nameless_save, const String& file_spec);
   
         bool locate(const String& column, const String& value);          template<typename I>
           bool locate(bool (*func)(Table& self, I* info), void* info, Action_options& o) {
                   size_t count=this->count();
                   if(!count || !o.limit)
                           return false;
                   size_t row=o.offset;
                   if(row>=count)
                           return false;
                   // max(limit)
                   size_t m=o.reverse?
                           o.offset
                           :count-o.offset;
                   if(!m)
                           return false;
                   // fix limit
                   if(o.limit==ARRAY_OPTION_LIMIT_ALL || o.limit>m)
                           o.limit=m;
   
                   size_t saved_current=current();
                   if(o.reverse) { // reverse
                           for(size_t to=row-o.limit; row>=to; --row) {
                                   set_current(row);
   
                                   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);
   
 private:                  return false;
                   }
         // where this table came from, may be NULL  
         const String *forigin_string;  
   
         // column name->number lookup table          bool locate(int column, const String& value, Action_options& options);
         Hash name2number;          bool locate(const String& column, const String& value, Action_options& options);
   
   private:
           
         // current row          // current row
         int fcurrent;          size_t fcurrent;
   
         // columns          // columns
         Array *fcolumns;          columns_type fcolumns;
   
         bool valid(int index) const { return index>=0 && index<size(); }          // column names are already referenced in fcolumns, no need to doublecheck references here
           // column name->number lookup table
         const Array& at(int index) const {          typedef Hash<const StringBody, int> name2number_hash_class;
                 // force @c const result          name2number_hash_class* name2number;
                 return *const_cast<const Array *>(static_cast<Array *>(get(index)));  
         }  
   
         /// @return column index from @a column_name          // we own columns?
         int column_name2index(const String& column) const;  
   
         const String *item(int column) const;          bool valid(size_t index) const { return index>=0 && index<count(); }
   
 };  };
   

Removed from v.1.25  
changed lines
  Added in v.1.48.2.11.2.9


E-mail: