|
|
| version 1.6, 2001/01/30 13:07:31 | 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: |
| Table(Request& arequest, | Table(Pool& apool, |
| char *afile, uint aline, | const String *aorigin, |
| Array *acolumns, | const 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); | |
| // the base origin of table's data | /// where this table came from, may be NULL |
| //const Origin& origin() { return forigin; } | const String *origin_string() { return forigin_string; } |
| /// gets column names | |
| const Array *columns() { return fcolumns; } | const Array *columns() { return fcolumns; } |
| void set_current(int acurrent) { fcurrent=acurrent; } | /// assignes column names |
| int get_current() { return fcurrent; } | void set_columns(const Array *acolumns) { fcolumns=acolumns; } |
| void inc_current() { fcurrent++; } | |
| void read_item(String& result, const String& column_name) { | /// moves @a current pointer |
| result.APPEND(item(column_name), forigin.file, forigin.line+fcurrent); | 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; | |
| } | } |
| protected: | /// saves to text file |
| void save(bool nameless_save, const String& file_spec); | |
| // the request I'm processed on. for error reporting | bool locate(int column, const String& value); |
| Request& request; | 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))); | |
| } | |
| // the base origin of table's data | private: |
| Origin forigin; | |
| // 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; |
| Line 52 protected: | Line 91 protected: |
| int fcurrent; | int fcurrent; |
| // columns | // columns |
| Array *fcolumns; | const Array *fcolumns; |
| const Array *at(int index); | bool valid(int index) const { return index>=0 && index<size(); } |
| const char *item(int column_index); | |
| const char *item(const String& column_name); | |
| }; | }; |
| #endif | #endif |