BloombergLP::bdlt::FixUtil::parse

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.

Synopsis

Declared in <bdlt_fixutil.h>

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