|
virtual | ~DataModelImport () |
|
GdaDataModelImport* | gobj () |
| Provides access to the underlying C GObject. More...
|
|
const GdaDataModelImport* | gobj () const |
| Provides access to the underlying C GObject. More...
|
|
GdaDataModelImport* | gobj_copy () |
| Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...
|
|
GSList* | get_errors () |
| Get the list of errors which model has to report. More...
|
|
void | clean_errors () |
| Clears the history of errors model has to report. More...
|
|
Glib::PropertyProxy_ReadOnly
< Glib::ustring > | property_data_string () const |
| String to import. More...
|
|
Glib::PropertyProxy_ReadOnly
< std::string > | property_filename () const |
| File to import. More...
|
|
Glib::PropertyProxy_ReadOnly
< Glib::RefPtr< Set > > | property_options () const |
| Options to configure the import. More...
|
|
Glib::PropertyProxy_ReadOnly
< bool > | property_random_access () const |
| Random access to the data model is possible. More...
|
|
Glib::PropertyProxy_ReadOnly
< xmlNodePtr > | property_xml_node () const |
| XML node to import from. More...
|
|
virtual | ~DataModel () |
|
GdaDataModel* | gobj () |
| Provides access to the underlying C GObject. More...
|
|
const GdaDataModel* | gobj () const |
| Provides access to the underlying C GObject. More...
|
|
void | freeze () |
| Disables notifications of changes on the given data model. More...
|
|
void | thaw () |
| Re-enables notifications of changes on the given data model. More...
|
|
int | get_n_rows () const |
|
int | get_n_columns () const |
|
int | get_column_index (const Glib::ustring& name) |
| Get the index of the first column named name in model. More...
|
|
Glib::RefPtr< Column > | describe_column (int col) |
| Queries the underlying data model implementation for a description of a given column. More...
|
|
Glib::RefPtr< const Column > | describe_column (int col) const |
| Queries the underlying data model implementation for a description of a given column. More...
|
|
Glib::ustring | get_column_title (int col) const |
|
void | set_column_title (int col, const Glib::ustring& title) |
| Sets the title of the given col in model. More...
|
|
Value | get_value_at (int col, int row) const |
| Retrieves the data stored in the given position (identified by the col and row parameters) on a data model. More...
|
|
Value | get_typed_value_at (int col, int row, GType expected_type, bool nullok) const |
| Upon errors 0 will be returned and error will be assigned a Error from the Gda::DATA_MODEL_ERROR domain. More...
|
|
ValueAttribute | get_attributes_at (int col, int row) |
| Get the attributes of the value stored at (row, col) in model, which is an ORed value of Gda::ValueAttribute flags. More...
|
|
Glib::RefPtr< DataModelIter > | create_iter () |
| Creates a new iterator object Gda::DataModelIter object which can be used to iterate through rows in model. More...
|
|
bool | set_value_at (int col, int row, const Value& value) |
| Modifies a value in model, at ( col, row). More...
|
|
bool | set_values (int row, const std::vector< Value >& values) |
| In a similar way to set_value_at(), this method modifies a data model's contents by setting several values at once. More...
|
|
DataModelAccessFlags | get_access_flags () const |
| Get the attributes of model such as how to access the data it contains if it's modifiable, etc. More...
|
|
int | append_values (const std::vector< Value >& values) |
| Appends a row to the given data model. More...
|
|
bool | append_row () |
| Appends a row to the data model (the new row will possibly have 0 values for all columns, or some other values depending on the data model implementation) More...
|
|
bool | remove_row (int row) |
| Removes a row from the data model. More...
|
|
int | get_row_from_values (const ValueVector& values, const std::vector< int >& cols_index) |
| Returns the first row where all the values in values at the columns identified at cols_index match. More...
|
|
void | send_hint (DataModelHint hint, const Value& hint_value) |
| Sends a hint to the data model. More...
|
|
Glib::ustring | export_to_string (DataModelIOFormat format, const std::vector< int >& cols, const std::vector< int >& rows, const Glib::RefPtr< Set >& options) |
| Exports data contained in model to the a string; the format is specified using the format argument. More...
|
|
bool | export_to_file (DataModelIOFormat format, const std::string& file, const std::vector< int >& cols, const std::vector< int >& rows, const Glib::RefPtr< Set >& options) |
| Exports data contained in model to the file; the format is specified using the format argument. More...
|
|
bool | import_from_model (const Glib::RefPtr< DataModel >& from, bool overwrite, GHashTable* cols_trans) |
| Copy the contents of the from data model to the to data model. More...
|
|
bool | import_from_string (const Glib::ustring& string, GHashTable* cols_trans, const Glib::RefPtr< const Set >& options) |
| Loads the data from string into model. More...
|
|
bool | import_from_file (const std::string& file, GHashTable* cols_trans, const Glib::RefPtr< const Set >& options) |
| Imports data contained in the file file into model; the format is detected. More...
|
|
void | dump (FILE* to_stream) const |
| Dumps a textual representation of the model to the to_stream stream. More...
|
|
Glib::ustring | dump_as_string () const |
| Dumps a textual representation of the model into a new string. More...
|
|
void | set_column_name (int col, const Glib::ustring& name) |
| Sets the name of the given col in model, and if its title is not set, also sets the title to name. More...
|
|
Glib::ustring | get_column_name (int col) const |
|
bool | iter_move_next_default (const Glib::RefPtr< DataModelIter >& iter) |
|
bool | iter_move_prev_default (const Glib::RefPtr< DataModelIter >& iter) |
|
bool | iter_move_to_row_default (const Glib::RefPtr< DataModelIter >& iter, int row) |
|
Glib::SignalProxy1< void, int > | signal_row_inserted () |
|
Glib::SignalProxy1< void, int > | signal_row_updated () |
|
Glib::SignalProxy1< void, int > | signal_row_removed () |
|
Glib::SignalProxy0< void > | signal_reset () |
|
Glib::SignalProxy0< void > | signal_changed () |
|
Importing data from a string or a file.
This data model imports data from a string or a file. The data can either be in a CSV (comma separated values) format or in an XML format as described by the libgda-array.dtd DTD (It is also possible to import data from an already-build XML tree validated against that DTD). The caller must decide, upon construction, if the new DataModelImport must support random access or simply cursor based access. Random access makes it easier to use the resulting data model but consumes more memory as all the data is copied in memory, and this is thus not suitable for large data sets. Note that importing from an already-built XML tree will always result in a random access data model.
Various import options can be specified using parameters in a Set object. The available options depend on the format of the imported data listed here:
- "SEPARATOR" (string, CVS import only): specifies the separator to consider.
- "ESCAPE_CHAR" (string, CVS import only): specifies the character used to "escape" the strings contained between two separators.
- "ENCODING" (string, CVS import only): specifies the character set used in the imported data.
- "TITLE_AS_FIRST_LINE" (boolean, CVS import only): TRUE to specify that the first line of the imported data contains the column names.
- "GDA_TYPE_<col number>" (gda type, CVS import only): specifies the requested GDA type for the column numbered "col number".
- "DBMS_TYPE_<col number>" (string, CVS import only): specifies the requested DBMS type for the column numbered "col number"; if the DBMS type is listed in the dictionary used by the created model, then the GDA type is set in accordance.