Next: 6. Template Queries
Up: Usage
Previous: 4. Tutorial by Example
Subsections
This chapter documents all of the classes that are meant to be used. If it is
not documented here don't use it because it is a internal method or
class meant to only be used by other related classes.
5.1 Manipulators
The following manipulators modify only the next item to the right of it in an
<< chain. They can be used with any ostream (which
includes SQLQuery and Query because they are also ostreams)
or SQLQueryParms. When used with SQLQueryParms they will override
any settings set by the Template Query for that particular item.
- quote
- Quote and escape the next item. Can be used with ostream or
SQLQueryParms.
- quote_only
- Quote but don't escape the next item. Can be used with ostream
or SQLQueryParms.
- quote_only_double
- Quote, but don't escape the next item, with `` instead
of '.
- escape
- Escape the next item.
- do_nothing
- Does exactly what it says nothing. Used as a dummy manipulator
when you are required to use some manipulator. When used with SQLQueryParms
it will make sure that it does not get formatted in any way overriding any setting
set by the template query.
- ignore
- Only valid when used with SQLQueryParms. Like do_nothing
however this one will not override formatting set by the template query, thus
it is ignored.
Since version 1.6, automatic quoting and escaping has been added to manipulators.
This mechanism is applied to mysql_ColData only, iso epse to the class very
frequentrly uitlized as a return object of Row[] index. Automatic quoting
or escaping is used with << operator only,
and on all stream derived classes and objects, including strstream, query objects,
but excepting cout, cerr and clog. This has been designed so intentionally,
as streaming out values to those objects does not require quoting or escaping.
But this feature comes handy when you construct query's by streaming values
to query object or to strstream class object.
This feature can be glibally turned of by setting value dont_quote_auto
in your code to true.
Next: 6. Template Queries
Up: Usage
Previous: 4. Tutorial by Example
2000-11-14