unformat: formatted read from string

Functions
template<class Arg , class... Args>
size_t	c4::unformat (csubstr buf, csubstr fmt, Arg &a, Args &...more)
	using a format string, deserialize the arguments from the given buffer. More...

Detailed Description

Function Documentation

unformat()

template<class Arg , class... Args>

size_t c4::unformat	(	csubstr	buf,
		csubstr	fmt,
		Arg &	a,
		Args &...	more
	)

using a format string, deserialize the arguments from the given buffer.

Returns

the number of characters read from the buffer, or npos if a conversion failed.

See also

c4::format(). c4::unformat() is the inverse function to format().

Definition at line 864 of file format.hpp.

{
    const size_t pos = fmt.find("{}");
    if(C4_UNLIKELY(pos == csubstr::npos))
        return unformat(buf, fmt);
    size_t num = pos;
    size_t out = num;
    buf  = buf.len >= num ? buf.sub(num) : substr{};
    num  = from_chars_first(buf, &a);
    if(C4_UNLIKELY(num == csubstr::npos))
        return csubstr::npos;
    out += num;
    buf  = buf.len >= num ? buf.sub(num) : substr{};
    num  = unformat(buf, fmt.sub(pos + 2), more...);
    if(C4_UNLIKELY(num == csubstr::npos))
        return csubstr::npos;
    out += num;
    return out;
}

References c4::from_chars_first(), and c4::yml::npos.

Referenced by sample::from_chars(), and sample::sample_formatting().