Convert

class Convert

Convert-derived classes serve as bidirectional Value-Value converters. One direction is represented by Format method and usually converts the Value to the textual representation. Reverse direction is represented by the Scan method.

If the conversion is not possible (e.g. due to invalid textual representation), convert methods should return "ErrorValue" to indicate the problem.

virtual Value Format(const Value& q) const

Converts the Value. Default implementation uses Value::ToString to convert the Value.

virtual Value Scan(const Value& text) const

Converts the Value in reverse direction. Default implementation returns text (no conversion is performed).

virtual int Filter(int chr) const

Adjusts characters allowed in textual representation of Value.

Value operator()(const Value& q) const

Invokes the Format method. Helper functor-like syntax.

class ConvertDate : public Convert

Date Converter. Textual date format depends on actual regional settings.

Derived from Convert

virtual Value Scan(const Value& text) const

Sets the range of Dates allowed.

ConvertDate& Min(Date _min)

Sets minimal allowed Date.

ConvertDate& Max(Date _max)

Sets maximal allowed Date.

ConvertDate& NotNull(bool b = true)

Allows/disallows Null dates. (Null dates are represented by the empty text).

ConvertDate& NoNotNull()

Same as NotNull(false).

Date GetMin() const

Date GetMax() const

bool IsNotNull() const

ConvertDate(Date minval = Date(0, 0, 0), Date maxval = Date(9999, 12, 31), bool notnull = false)

Constructor.

class ConvertDouble : public Convert

Floating point number converter.

Derived from Convert

ConvertDouble& Pattern(const char *p)

Formatting tag used for conversion to textual representation (includes standard printf formatting tags, see Format function for description). Default tag is %.10g.

ConvertDouble& MinMax(double _min, double _max)

Sets minimal and maximal allowed numbers.

ConvertDouble& Min(double _min)

Sets minimal allowed number.

ConvertDouble& Max(double _max)

Sets maximal allowed number.

ConvertDouble& NotNull(bool b = true)

Allows/disallows Nulls. (Nulls are represented by the empty text).

ConvertDouble& NoNotNull()

Equivalent to NotNull(false).

double GetMin() const

double GetMax() const

bool IsNotNull() const

ConvertDouble(double minval = DOUBLE_NULL_LIM, double maxval = -DOUBLE_NULL_LIM, bool notnull = false)

Constructor.

class ConvertInt : public Convert

Integer converter.

Derived from Convert

ConvertInt& MinMax(int _min, int _max)

Sets minimal and maximal allowed numbers.

ConvertInt& Min(int _min)

Sets minimal allowed number.

ConvertInt& Max(int _max)

Sets maximal allowed number.

ConvertInt& NotNull(bool b = true)

Allows/disallows Nulls. (Nulls are represented by the empty text).

ConvertInt& NoNotNull()

Equivalent to NotNull(false).

int GetMin() const

int GetMax() const

bool IsNotNull() const

ConvertInt(int minval = -INT_MAX, int maxval = INT_MAX, bool notnull = false)

Constructor.

class ConvertString : public Convert

String "converter". Of course, String already is textual representation of itself, the real purpose of this class is to introduce constraints of String value.

Derived from Convert

ConvertString& MaxLen(int _maxlen)

Sets maximum length of String allowed.

int GetMaxLength() const

ConvertString& NotNull(bool b = true)

Disallows empty Strings.

ConvertString& NoNotNull()

Same as NotNull(false).

bool IsNotNull() const

ConvertString(int maxlen = INT_MAX, bool notnull = false)

Constructor.

class ConvertTime : public Convert

Time converter.

Derived from Convert

ConvertTime& MinMax(Time _min, Time _max)

Time limeits.

ConvertTime& NotNull(bool b = true)

Disallows empty Strings.

ConvertTime& NoNotNull()

Same as NotNull(false).

Time GetMin() const

Time GetMax() const

bool IsNotNull() const

ConvertTime(Time minval = Null, Time maxval = Null, bool notnull = false)

Constructor.

class FormatConvert : public Convert

This unidirectional Convert class (only Format direction implemented) converts single Value or ValueArray using Format function and specified formatter pattern.

Derived from Convert

void SetFormat(const char *fmt)

Sets formatting pattern.

class JoinConvert : public Convert

This unidirectional Convert class (only Format direction is implemented) converts ValueArray using a set of other Convert instances. Resulting textual representation is created by joining a set of defined elements - some of them static texts, others referring to elements of input ValueArray, converted using specified Convert.

Derived from Convert

JoinConvert& Add(const char *text)

Adds static text to the list of elements.

JoinConvert& Add(int pos, const Convert& cv)

Add element referring to input value, to be converted using specified Convert.

JoinConvert& Add(int pos)

Add element referring to input value, to be converted using default Convert.

JoinConvert& Add(const Convert& cv)

Add element referring to input value, to be converted using specified Convert. Index of input element is the index of previous input element plus 1.

JoinConvert& Add()

Add element referring to input value, to be converted using default Convert. Index of input element is the index of previous input element plus 1.

Standard Converts

Standard converts are simple global functions returning a constant reference to the single global variable representing the particular Convert class. Following table lists names of these functions and respective constructors of Convert classes used to create global variable