|
|
| version 1.48.2.6, 2003/01/28 12:16:18 | version 1.77, 2024/12/08 01:16:42 |
|---|---|
| Line 1 | Line 1 |
| /** @file | /** @file |
| Parser: table class decl. | Parser: table class decl. |
| Copyright (c) 2001, 2003 ArtLebedev Group (http://www.artlebedev.com) | Copyright (c) 2001-2024 Art. Lebedev Studio (http://www.artlebedev.com) |
| Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru) | Authors: Konstantin Morshnev <moko@design.ru>, Alexandr Petrosian <paf@design.ru> |
| */ | */ |
| #ifndef PA_TABLE_H | #ifndef PA_TABLE_H |
| #define PA_TABLE_H | #define PA_TABLE_H |
| static const char* IDENT_TABLE_H="$Date$"; | #define IDENT_PA_TABLE_H "$Id$" |
| #include "pa_types.h" | #include "pa_types.h" |
| #include "pa_hash.h" | #include "pa_hash.h" |
| #include "pa_string.h" | #include "pa_string.h" |
| class Temp_current; | |
| /** | /** |
| VTable backend. | VTable backend. |
| Line 28 static const char* IDENT_TABLE_H="$Date$ | Line 30 static const char* IDENT_TABLE_H="$Date$ |
| rows and strings stored are read-only. once stored they can be removed, | 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 | but not altered. that's handy for quick copying & co. see table:join |
| */ | */ |
| class Table: public Array<object_ptr<const Array<ConstStringPtr > > > { | class Table: public Array<ArrayString*> { |
| public: | public: |
| typedef object_ptr<const Array<ConstStringPtr> > columns_type; | typedef ArrayString* columns_type; |
| Table( | |
| ConstStringPtr aorigin_string, | |
| columns_type acolumns, | |
| int initial_rows=3); | |
| Table(const Table& src, int offset=0, int limit=0); | |
| /// where this table came from, may be NULL | Table(columns_type acolumns, size_t initial_rows=3); |
| ConstStringPtr origin_string() { return forigin_string; } | Table(const Table& src, Action_options& options); |
| /// gets column names | /// gets column names |
| columns_type columns() { return fcolumns; } | columns_type columns() { return fcolumns; } |
| /// moves @a current pointer | /// moves @a current pointer, can be out of range when restoring current in modified table |
| void set_current(int acurrent) { fcurrent=acurrent; } | void set_current(size_t acurrent) { |
| fcurrent=acurrent<count() ? acurrent : count()>0 ? count()-1 : 0; | |
| } | |
| /// @return current pointer | /// @return current pointer |
| int current() const { return fcurrent; } | size_t current() const { return fcurrent; } |
| void offset(bool absolute, int offset); | 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 | /** @return column index from @a column_name. '<0' if no such column |
| if no such - 'bark' | if no such - 'bark' |
| */ | */ |
| int column_name2index(ConstStringPtr column, bool bark) const; | int column_name2index(const String& column, bool bark) const; |
| void column_names_init(); | |
| /// @return item from @a column | /// @return item from @a column |
| ConstStringPtr item(int column) const; | 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 | /// @return item from @a column. '0' if no such column |
| ConstStringPtr item(ConstStringPtr column) const { | const String* item(const String& column) { |
| int index=column_name2index(column, false); | int index=column_name2index(column, false); |
| return index>=0?item(index):ConstStringPtr(0); | return index>=0?item(index):0; |
| } | } |
| /// saves to text file | /// saves to text file |
| void save(bool nameless_save, object_ptr<const String> file_spec); | void save(bool nameless_save, const String& file_spec); |
| bool locate(int column, ConstStringPtr value); | template<typename I> |
| bool locate(object_ptr<const String> column, ConstStringPtr value); | void table_for_each(void (*func)(Table& self, I* info), I* info, Action_options& o); |
| element_type at(int index) const { | template<typename I> |
| return get(index); | 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: | private: |
| // where this table came from, may be NULL | /// current row |
| ConstStringPtr forigin_string; | size_t fcurrent; |
| // current row | /// columns |
| int fcurrent; | |
| // columns | |
| columns_type fcolumns; | columns_type fcolumns; |
| // column names are already referenced in fcolumns, no need to doublecheck references here | /// column name->number lookup table |
| // column name->number lookup table | typedef HashString<int> name2number_hash_class; |
| typedef Hash<const String&, int> name2number_hash_class; | name2number_hash_class* name2number; |
| object_ptr<name2number_hash_class> name2number; | |
| // we own columns? | /// is that @c index falid? |
| bool valid(size_t index) const { return index<count(); } | |
| bool valid(int index) const { return index>=0 && index<count(); } | }; |
| /// Auto-object that temporarily saves and restores current | |
| class Temp_current { | |
| Table& ftable; | |
| size_t fcurrent; | |
| public: | |
| Temp_current(Table& atable) : ftable(atable), fcurrent(atable.current()){} | |
| ~Temp_current(){ | |
| ftable.set_current(fcurrent); | |
| } | |
| }; | }; |
| typedef object_ptr<Table> TablePtr; | template<typename I> void Table::table_for_each(void (*func)(Table& self, I* info), I* info, Action_options& o) { |
| if(!o.adjust(count())) | |
| return; | |
| Temp_current tc(*this); | |
| 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); | |
| } | |
| } | |
| } | |
| #endif | #endif |