catsep: cat arguments to string with separator

Functions
template<class Sep , class Arg , class... Args>
size_t	c4::catsep (substr buf, Sep const &sep, Arg const &a, Args const &...more)
	serialize the arguments, concatenating them to the given fixed-size buffer, using a separator between each argument. More...
template<class... Args>
substr	c4::catsep_sub (substr buf, Args &&...args)
	like c4::catsep() but return a substr instead of a size More...
template<class CharOwningContainer , class Sep , class... Args>
void	c4::catseprs (CharOwningContainer *cont, Sep const &sep, Args const &...args)
	catsep+resize: like c4::catsep(), but receives a container, and resizes it as needed to contain the result. More...
template<class CharOwningContainer , class Sep , class... Args>
CharOwningContainer	c4::catseprs (Sep const &sep, Args const &...args)
	catsep+resize: like c4::catsep(), but create a new container with the result. More...
template<class CharOwningContainer , class Sep , class... Args>
csubstr	c4::catseprs_append (CharOwningContainer *cont, Sep const &sep, Args const &...args)
	catsep+resize+append: like catsep(), but receives a container, and appends the arguments, resizing the container as needed to contain the result. More...

Detailed Description

Function Documentation

catsep()

template<class Sep , class Arg , class... Args>

size_t c4::catsep	(	substr	buf,
		Sep const &	sep,
		Arg const &	a,
		Args const &...	more
	)

serialize the arguments, concatenating them to the given fixed-size buffer, using a separator between each argument.

The buffer size is strictly respected: no writes will occur beyond its end.

Returns

the number of characters needed to write all the arguments into the buffer.

See also

c4::catseprs() if instead of a fixed-size buffer, a resizeable container is desired

c4::uncatsep() for the inverse function (ie, reading instead of writing)

c4::cat() if no separator is needed

c4::format() if a format string is desired

Definition at line 727 of file format.hpp.

{
    size_t num = to_chars(buf, a);
    buf  = buf.len >= num ? buf.sub(num) : substr{};
    num += detail::catsep_more(buf, sep, more...);
    return num;
}

References c4::to_chars().

catsep_sub()

template<class... Args>

substr c4::catsep_sub	(	substr	buf,
		Args &&...	args
	)

like c4::catsep() but return a substr instead of a size

See also

c4::catsep(). c4::uncatsep() is the inverse of c4::catsep().

Definition at line 738 of file format.hpp.

{
    size_t sz = catsep(buf, std::forward<Args>(args)...);
    C4_CHECK(sz <= buf.len);
    return {buf.str, sz <= buf.len ? sz : buf.len};
}

References c4::catsep().

catseprs() [1/2]

template<class CharOwningContainer , class Sep , class... Args>

void c4::catseprs ( CharOwningContainer *  cont, Sep const &  sep, Args const &...  args  )

inline

catsep+resize: like c4::catsep(), but receives a container, and resizes it as needed to contain the result.

The container is overwritten. To append to the container use the append overload.

See also

c4::catsep()

Definition at line 951 of file format.hpp.

{
retry:
    substr buf = to_substr(*cont);
    size_t ret = catsep(buf, sep, args...);
    cont->resize(ret);
    if(ret > buf.len)
        goto retry;
}

References c4::catsep(), and c4::to_substr().

catseprs() [2/2]

template<class CharOwningContainer , class Sep , class... Args>

CharOwningContainer c4::catseprs ( Sep const &  sep, Args const &...  args  )

inline

catsep+resize: like c4::catsep(), but create a new container with the result.

Returns

the requested container

Definition at line 967 of file format.hpp.

{
    CharOwningContainer cont;
    catseprs(&cont, sep, args...);
    return cont;
}

References c4::catseprs().

catseprs_append()

template<class CharOwningContainer , class Sep , class... Args>

csubstr c4::catseprs_append ( CharOwningContainer *  cont, Sep const &  sep, Args const &...  args  )

inline

catsep+resize+append: like catsep(), but receives a container, and appends the arguments, resizing the container as needed to contain the result.

The buffer is appended to.

Returns

a csubstr of the appended part

Definition at line 982 of file format.hpp.

{
    const size_t pos = cont->size();
retry:
    substr buf = to_substr(*cont).sub(pos);
    size_t ret = catsep(buf, sep, args...);
    cont->resize(pos + ret);
    if(ret > buf.len)
        goto retry;
    return to_csubstr(*cont).range(pos, cont->size());
}

References c4::catsep(), c4::to_csubstr(), and c4::to_substr().