Return to pa_table.h CVS log

Up to [parser3project] / parser3 / src / include

Annotation of parser3/src/include/pa_table.h, revision 1.48.2.3

1.14      paf         1: /** @file
1.15      paf         2:        Parser: table class decl.
                      3: 
1.48      paf         4:        Copyright (c) 2001, 2003 ArtLebedev Group (http://www.artlebedev.com)
1.41      paf         5:        Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
1.1       paf         6: */
                      7: 
                      8: #ifndef PA_TABLE_H
                      9: #define PA_TABLE_H
1.45      paf        10: 
1.48.2.3! paf        11: static const char* IDENT_TABLE_H="$Date: 2003/01/23 16:08:01 $";
1.1       paf        12: 
                     13: #include "pa_types.h"
                     14: #include "pa_array.h"
                     15: #include "pa_hash.h"
1.2       paf        16: #include "pa_string.h"
1.1       paf        17: 
1.16      paf        18: /** 
1.19      paf        19:        VTable backend.
1.16      paf        20: 
                     21:        holds:
1.14      paf        22:        - column names[if any]
                     23:        - data rows
                     24:        - current row pointer
                     25: 
                     26:        uses String for column names and data items
                     27: 
1.28      paf        28:        hence most of tables are "named", no need to uptimize nameless onces.
                     29:        rows and strings stored are read-only. once stored they can be removed,
                     30:        but not altered. that's handy for quick copying & co. see table:join
1.14      paf        31: */
1.48.2.1  paf        32: class Table: public Array<object_ptr<const Array<object_ptr<const String> > > > {
1.1       paf        33: public:
1.48.2.2  paf        34:        typedef object_ptr<const String> column_type;
                     35:        typedef object_ptr<const String> value_type;
                     36: 
1.1       paf        37: 
1.48.2.1  paf        38:        Table(
1.48.2.3! paf        39:                ConstStringPtr aorigin_string,
1.48.2.2  paf        40:                object_ptr<const Array<column_type> > acolumns,
1.48.2.1  paf        41:                int initial_rows=3);
                     42:        Table(const Table& src, int offset=0, int limit=0);
1.2       paf        43: 
1.21      paf        44:        /// where this table came from, may be NULL
1.48.2.3! paf        45:        ConstStringPtr origin_string() { return forigin_string; }
1.21      paf        46: 
1.42      paf        47:        /// gets column names
1.48.2.2  paf        48:        object_ptr<const Array<column_type> > columns() { return fcolumns; }
1.5       paf        49: 
1.18      paf        50:        /// moves @a current pointer
1.5       paf        51:        void set_current(int acurrent) { fcurrent=acurrent; }
1.17      paf        52:        /// @return current pointer
1.47      paf        53:        int current() const { return fcurrent; }
1.37      paf        54:        void offset(bool absolute, int offset);
1.5       paf        55: 
1.32      paf        56:        /** @return column index from @a column_name. '<0' if no such column
1.48.2.1  paf        57:                if no such - 'bark'
1.32      paf        58:        */
1.48.2.2  paf        59:        int column_name2index(column_type column, bool bark) const;
1.30      paf        60: 
1.26      paf        61:        /// @return item from @a column
1.48.2.2  paf        62:        value_type item(int column) const;
1.30      paf        63: 
                     64:        /// @return item from @a column. '0' if no such column
1.48.2.2  paf        65:        value_type item(column_type column) const {
1.32      paf        66:                int index=column_name2index(column, false);
1.48.2.2  paf        67:                return index>=0?item(index):value_type(0);
1.24      paf        68:        }
1.23      paf        69: 
                     70:        /// saves to text file
1.48.2.2  paf        71:        void save(bool nameless_save, object_ptr<const String> file_spec);
1.2       paf        72: 
1.48.2.2  paf        73:        bool locate(int column, value_type value);
                     74:        bool locate(object_ptr<const String> column, value_type value);
1.24      paf        75: 
1.48.2.1  paf        76:        element_type at(int index) const {
                     77:                return get(index);
1.27      paf        78:        }
                     79: 
1.12      paf        80: private:
1.21      paf        81:        
                     82:        // where this table came from, may be NULL
1.48.2.3! paf        83:        ConstStringPtr forigin_string;
1.1       paf        84: 
1.5       paf        85:        // current row
                     86:        int fcurrent;
                     87: 
                     88:        // columns
1.48.2.2  paf        89:        object_ptr<const Array<column_type> > fcolumns;
1.48.2.1  paf        90: 
                     91:        // column names are already referenced in fcolumns, no need to doublecheck references here
                     92:        // column name->number lookup table
                     93:        typedef Hash<String, int> name2number_hash_class;
                     94:        object_ptr<name2number_hash_class> name2number;
                     95: 
                     96:        // we own columns?
1.5       paf        97: 
1.48.2.1  paf        98:        bool valid(int index) const { return index>=0 && index<count(); }
1.2       paf        99: 
1.1       paf       100: };
1.48.2.3! paf       101: 
        !           102: typedef object_ptr<Table> TablePtr;
1.1       paf       103: 
                    104: #endif