|
|
| version 1.2, 2001/01/29 20:10:32 | version 1.43, 2002/04/22 14:11:28 |
|---|---|
| Line 1 | Line 1 |
| /* | /** @file |
| $Id$ | Parser: table class decl. |
| */ | |
| /* | Copyright (c) 2001, 2002 ArtLebedev Group (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) |
| */ | |
| $Id$ | |
| */ | |
| #ifndef PA_TABLE_H | #ifndef PA_TABLE_H |
| #define PA_TABLE_H | #define PA_TABLE_H |
| Line 14 | Line 14 |
| #include "pa_array.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. | |
| holds: | |
| - column names[if any] | |
| - data rows | |
| - current row pointer | |
| uses String for column names and data items | |
| 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 { |
| public: | public: |
| // request I'm processed on | Table(Pool& apool, |
| Request& request; | const String *aorigin, |
| const Array *acolumns, | |
| // the base origin of table data | |
| Origin origin; | |
| int current; | |
| // columns | |
| Array *columns; | |
| Table(Request& request, | |
| char *afile, uint aline, | |
| Array *acolumns, | |
| int initial_rows=CR_INITIAL_ROWS_DEFAULT); | int initial_rows=CR_INITIAL_ROWS_DEFAULT); |
| Table(const Table& source); | |
| Table(Pool& apool, const Table& source, int offset=0); | |
| /// where this table came from, may be NULL | |
| const String *origin_string() { return forigin_string; } | |
| char *item(int column_index); | /// gets column names |
| char *item(String column_name); | const Array *columns() { return fcolumns; } |
| protected: | /// assignes column names |
| void set_columns(const Array *acolumns) { fcolumns=acolumns; } | |
| /// moves @a current pointer | |
| void set_current(int acurrent) { fcurrent=acurrent; } | |
| /// @return current pointer | |
| int current() { return fcurrent; } | |
| void offset(bool absolute, int offset); | |
| /** @return column index from @a column_name. '<0' if no such column | |
| if no such colum conditionally 'bark' | |
| */ | |
| int column_name2index(const String& column, bool bark) const; | |
| /// @return item from @a column | |
| const String *item(int column) const; | |
| /// @return item from @a column. '0' if no such column | |
| const String *item(const String& column) const { | |
| 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); | |
| bool locate(int column, const String& value); | |
| bool locate(const String& column, const String& value); | |
| const Array& at(int index) const { | |
| // force @c const result | |
| return *const_cast<const Array *>(static_cast<Array *>(get(index))); | |
| } | |
| private: | |
| // where this table came from, may be NULL | |
| const String *forigin_string; | |
| // column name->number lookup table | // column name->number lookup table |
| Hash name2number; | Hash name2number; |
| Array *at(int index); | // current row |
| int fcurrent; | |
| // columns | |
| const Array *fcolumns; | |
| bool valid(int index) const { return index>=0 && index<size(); } | |
| }; | }; |