diff options
Diffstat (limited to 'doc/reference/field.adoc')
-rw-r--r-- | doc/reference/field.adoc | 42 |
1 files changed, 0 insertions, 42 deletions
diff --git a/doc/reference/field.adoc b/doc/reference/field.adoc deleted file mode 100644 index 572719d..0000000 --- a/doc/reference/field.adoc +++ /dev/null @@ -1,42 +0,0 @@ -== `sqlite/field.hpp` - -A `field` is a type representing a <<value>> in a database. or as a result from a query. - -.Definition -[source,cpp] ----- - -struct field -{ - typedef sqlite_int64 int64; - - // The type of the value - value_type type() const; - // Is the held value null - bool is_null() const; - // Is the held value is not null - explicit operator bool () const; - // Returns the value as an `int64`. - int64 get_int() const; - // Returns the value as an `double`. - double get_double() const; - // Returns the value as text, i.e. a string_view. Note that this value may be invalidated - cstring_ref get_text() const; - // Returns the value as blob, i.e. raw memory. Note that this value may be invalidated - blob_view get_blob() const; - // Returns the field as a value. - value get_value() const; - // Returns the name of the column. - cstring_ref column_name() const; - // Returns the name of the table. - cstring_ref table_name() const; - // Returns the name of the original data source. - cstring_ref column_origin_name() const; -} ----- - -NOTE: The view types can be invalidated when the database changes or the next row is read by the query. - -WARNING: The `field` type does not own the statement/query it was produced by. It is a merely a view into the `resultset`. -Reading the next row will change the values returned. - |