parse overloads

Synopses

Declared in <bdlt_fixutil.h>

Parse the specified FIX string as a Date value, and load the value into the specified result. Return 0 on success, and a non‐zero value (with no effect) otherwise. string is assumed to be of the form: ` YYYYMMDD{(+|‐)hh{:mm}|Z} ` Exactly string.length() characters are parsed; parsing will fail if a proper prefix of string matches the expected format, but the entire string.length() characters do not. If the optional timezone offset is present in string, it is parsed but ignored. The behavior is undefined unless string.data() is non‐null.

static
int
parse(
    Date* result,
    std::string_view const& string);

Parse the specified FIX string as a DateTz value, and load the value into the specified result. Return 0 on success, and a non‐zero value (with no effect) otherwise. string is assumed to be of the form: ` YYYYMMDD{(+|‐)hh{:mm}|Z} ` Exactly string.length() characters are parsed; parsing will fail if a proper prefix of string matches the expected format, but the entire string.length() characters do not. If the optional timezone offset is not present in string, UTC is assumed. The behavior is undefined unless string.data() is non‐null.

static
int
parse(
    DateTz* result,
    std::string_view const& string);

Parse the specified FIX string as a Datetime value, and load the value into the specified result. Return 0 on success, and a non‐zero value (with no effect) otherwise. string is assumed to be of the form: ` YYYYMMDD‐hh:mm{:ss{.s+}}{(+|‐)hh{:mm}|Z} ` Exactly string.length() characters are parsed; parsing will fail if a proper prefix of string matches the expected format, but the entire string.length() characters do not. If an optional fractional second having more than six digits is present in string, it is rounded to the nearest value in microseconds. If the optional timezone offset is present in string, the resulting Datetime value is converted to the equivalent UTC value; if the timezone offset is absent, UTC is assumed. If a leap second is detected (i.e., the parsed value of the second attribute is 60; see {Leap Seconds}), the second attribute is taken to be 59, then an additional second is added to result at the end. The behavior is undefined unless string.data() is non‐null.

static
int
parse(
    Datetime* result,
    std::string_view const& string);

Parse the specified FIX string as a DatetimeTz value, and load the value into the specified result. Return 0 on success, and a non‐zero value (with no effect) otherwise. string is assumed to be of the form: ` YYYYMMDD‐hh:mm{:ss{.s+}}{(+|‐)hh{:mm}|Z} ` Exactly string.length() characters are parsed; parsing will fail if a proper prefix of string matches the expected format, but the entire string.length() characters do not. If an optional fractional second having more than six digits is present in string, it is rounded to the nearest value in microseconds. If the optional timezone offset is not present in string, UTC is assumed. If a leap second is detected (i.e., the parsed value of the second attribute is 60; see {Leap Seconds}), the second attribute is taken to be 59, then an additional second is added to result at the end. The behavior is undefined unless string.data() is non‐null.

static
int
parse(
    DatetimeTz* result,
    std::string_view const& string);

Parse the specified FIX string as a Time value, and load the value into the specified result. Return 0 on success, and a non‐zero value (with no effect) otherwise. string is assumed to be of the form: ` hh:mm{:ss{.s+}}{(+|‐)hh{:mm}|Z} ` Exactly string.length() characters are parsed; parsing will fail if a proper prefix of string matches the expected format, but the entire string.length() characters do not. If an optional fractional second having more than six digits is present in string, it is rounded to the nearest value in microseconds. If the optional timezone offset is present in string, the resulting Time value is converted to the equivalent UTC time; if the timezone offset is absent, UTC is assumed. If a leap second is detected (i.e., the parsed value of the second attribute is 60; see {Leap Seconds}), the second attribute is taken to be 59, then an additional second is added to result at the end. The behavior is undefined unless string.data() is non‐null.

static
int
parse(
    Time* result,
    std::string_view const& string);

Parse the specified FIX string as a TimeTz value, and load the value into the specified result. Return 0 on success, and a non‐zero value (with no effect) otherwise. string is assumed to be of the form: ` hh:mm{:ss{.s+}}{(+|‐)hh{:mm}|Z} ` Exactly string.length() characters are parsed; parsing will fail if a proper prefix of string matches the expected format, but the entire string.length() characters do not. If an optional fractional second having more than six digits is present in string, it is rounded to the nearest value in microseconds. If the optional timezone offset is not present in string, UTC is assumed. If a leap second is detected (i.e., the parsed value of the second attribute is 60; see {Leap Seconds}), the second attribute is taken to be 59, then an additional second is added to result at the end. The behavior is undefined unless string.data() is non‐null.

static
int
parse(
    TimeTz* result,
    std::string_view const& string);

Parse the specified initial length characters of the specified FIX string as a Date value, and load the value into the specified result. Return 0 on success, and a non‐zero value (with no effect) otherwise. string is assumed to be of the form: ` YYYYMMDD{(+|‐)hh{:mm}|Z} ` Exactly length characters are parsed; parsing will fail if a proper prefix of string matches the expected format, but the entire length characters do not. If the optional timezone offset is present in string, it is parsed but ignored. The behavior is undefined unless 0 <= length.

static
int
parse(
    Date* result,
    char const* string,
    int length);

Parse the specified initial length characters of the specified FIX string as a DateTz value, and load the value into the specified result. Return 0 on success, and a non‐zero value (with no effect) otherwise. string is assumed to be of the form: ` YYYYMMDD{(+|‐)hh{:mm}|Z} ` Exactly length characters are parsed; parsing will fail if a proper prefix of string matches the expected format, but the entire length characters do not. If the optional timezone offset is not present in string, UTC is assumed. The behavior is undefined unless 0 <= length.

static
int
parse(
    DateTz* result,
    char const* string,
    int length);

Parse the specified initial length characters of the specified FIX string as a Datetime value, and load the value into the specified result. Return 0 on success, and a non‐zero value (with no effect) otherwise. string is assumed to be of the form: ` YYYYMMDD‐hh:mm{:ss{.s+}}{(+|‐)hh{:mm}|Z} ` Exactly length characters are parsed; parsing will fail if a proper prefix of string matches the expected format, but the entire length characters do not. If an optional fractional second having more than six digits is present in string, it is rounded to the nearest value in microseconds. If the optional timezone offset is present in string, the resulting Datetime value is converted to the equivalent UTC value; if the timezone offset is absent, UTC is assumed. If a leap second is detected (i.e., the parsed value of the second attribute is 60; see {Leap Seconds}), the second attribute is taken to be 59, then an additional second is added to result at the end. The behavior is undefined unless 0 <= length.

static
int
parse(
    Datetime* result,
    char const* string,
    int length);

Parse the specified initial length characters of the specified FIX string as a DatetimeTz value, and load the value into the specified result. Return 0 on success, and a non‐zero value (with no effect) otherwise. string is assumed to be of the form: ` YYYYMMDD‐hh:mm{:ss{.s+}}{(+|‐)hh{:mm}|Z} ` Exactly length characters are parsed; parsing will fail if a proper prefix of string matches the expected format, but the entire length characters do not. If an optional fractional second having more than six digits is present in string, it is rounded to the nearest value in microseconds. If the optional timezone offset is not present in string, UTC is assumed. If a leap second is detected (i.e., the parsed value of the second attribute is 60; see {Leap Seconds}), the second attribute is taken to be 59, then an additional second is added to result at the end. The behavior is undefined unless 0 <= length.

static
int
parse(
    DatetimeTz* result,
    char const* string,
    int length);

Parse the specified initial length characters of the specified FIX string as a Time value, and load the value into the specified result. Return 0 on success, and a non‐zero value (with no effect) otherwise. string is assumed to be of the form: ` hh:mm:ss{.s+}{(+|‐)hh{:mm}|Z} ` Exactly length characters are parsed; parsing will fail if a proper prefix of string matches the expected format, but the entire length characters do not. If an optional fractional second having more than six digits is present in string, it is rounded to the nearest value in microseconds. If the optional timezone offset is present in string, the resulting Time value is converted to the equivalent UTC time; if the timezone offset is absent, UTC is assumed. If a leap second is detected (i.e., the parsed value of the second attribute is 60; see {Leap Seconds}), the second attribute is taken to be 59, then an additional second is added to result at the end. The behavior is undefined unless 0 <= length.

static
int
parse(
    Time* result,
    char const* string,
    int length);

Parse the specified initial length characters of the specified FIX string as a TimeTz value, and load the value into the specified result. Return 0 on success, and a non‐zero value (with no effect) otherwise. string is assumed to be of the form: ` hh:mm{:ss{.s+}}{(+|‐)hh{:mm}|Z} ` Exactly length characters are parsed; parsing will fail if a proper prefix of string matches the expected format, but the entire length characters do not. If an optional fractional second having more than six digits is present in string, it is rounded to the nearest value in microseconds. If the optional timezone offset is not present in string, UTC is assumed. If a leap second is detected (i.e., the parsed value of the second attribute is 60; see {Leap Seconds}), the second attribute is taken to be 59, then an additional second is added to result at the end. The behavior is undefined unless 0 <= length.

static
int
parse(
    TimeTz* result,
    char const* string,
    int length);

Created with MrDocs