Return to pa_table.h CVS log

Up to [parser3project] / parser3 / src / include

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

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.51    ! paf        11: static const char* IDENT_TABLE_H="$Date: 2003/04/14 11:22:53 $";
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.1       paf        32: class Table : public Array {
                     33: public:
1.49      paf        34:        struct Action_options {
1.51    ! paf        35:                int offset;
        !            36:                int limit; //< negative limit means 'all'. zero limit means 'nothing'
        !            37:                bool reverse;
        !            38:                bool defined;
        !            39:                
        !            40:                Action_options(
        !            41:                        int aoffset=0, 
        !            42:                        int alimit=-1, 
        !            43:                        bool areverse=false): 
        !            44:                        offset(aoffset), limit(alimit), reverse(areverse), 
        !            45:                        defined(false) {}
1.49      paf        46:        };
1.1       paf        47: 
1.11      paf        48:        Table(Pool& apool,
1.21      paf        49:                const String *aorigin,
1.34      parser     50:                const Array *acolumns,
1.2       paf        51:                int initial_rows=CR_INITIAL_ROWS_DEFAULT);
1.49      paf        52:        Table(Pool& apool, const Table& source, Action_options& options);
1.2       paf        53: 
1.21      paf        54:        /// where this table came from, may be NULL
                     55:        const String *origin_string() { return forigin_string; }
                     56: 
1.42      paf        57:        /// gets column names
1.5       paf        58:        const Array *columns() { return fcolumns; }
1.42      paf        59: 
                     60:        /// assignes column names
                     61:        void set_columns(const Array *acolumns) { fcolumns=acolumns; }
1.5       paf        62: 
1.18      paf        63:        /// moves @a current pointer
1.50      paf        64:        void set_current(int acurrent) {  fcurrent=acurrent; }
                     65:        
                     66:        /// @return current pointer
1.47      paf        67:        int current() const { return fcurrent; }
1.37      paf        68:        void offset(bool absolute, int offset);
1.5       paf        69: 
1.32      paf        70:        /** @return column index from @a column_name. '<0' if no such column
                     71:                if no such colum conditionally 'bark'
                     72:        */
                     73:        int column_name2index(const String& column, bool bark) const;
1.30      paf        74: 
1.26      paf        75:        /// @return item from @a column
                     76:        const String *item(int column) const;
1.30      paf        77: 
                     78:        /// @return item from @a column. '0' if no such column
                     79:        const String *item(const String& column) const {
1.32      paf        80:                int index=column_name2index(column, false);
1.30      paf        81:                return index>=0?item(index):0;
1.24      paf        82:        }
1.23      paf        83: 
                     84:        /// saves to text file
                     85:        void save(bool nameless_save, const String& file_spec);
1.2       paf        86: 
1.49      paf        87:        typedef bool (*locate_func)(Table& self, void* info);
                     88:        bool locate(locate_func func, void* info, Action_options& options);
                     89:        bool locate(int column, const String& value, Action_options& options);
                     90:        bool locate(const String& column, const String& value, Action_options& options);
1.24      paf        91: 
1.27      paf        92:        const Array& at(int index) const {
                     93:                // force @c const result
                     94:                return *const_cast<const Array *>(static_cast<Array *>(get(index)));
                     95:        }
                     96: 
1.12      paf        97: private:
1.21      paf        98:        
                     99:        // where this table came from, may be NULL
                    100:        const String *forigin_string;
1.5       paf       101: 
1.1       paf       102:        // column name->number lookup table
1.44      paf       103:        Hash& name2number;
1.1       paf       104: 
1.5       paf       105:        // current row
                    106:        int fcurrent;
                    107: 
                    108:        // columns
1.34      parser    109:        const Array *fcolumns;
1.5       paf       110: 
1.24      paf       111:        bool valid(int index) const { return index>=0 && index<size(); }
1.2       paf       112: 
1.1       paf       113: };
                    114: 
                    115: #endif