cat: concatenate arguments to string

Functions
template<class Arg , class... Args>
size_t	c4::cat (substr buf, Arg const &a, Args const &...more)
	serialize the arguments, concatenating them to the given fixed-size buffer. More...
template<class... Args>
substr	c4::cat_sub (substr buf, Args &&...args)
	like c4::cat() but return a substr instead of a size More...
template<class CharOwningContainer , class... Args>
void	c4::catrs (CharOwningContainer *cont, Args const &...args)
	cat+resize: like c4::cat(), but receives a container, and resizes it as needed to contain the result. More...
template<class CharOwningContainer , class... Args>
CharOwningContainer	c4::catrs (Args const &...args)
	cat+resize: like c4::cat(), but creates and returns a new container sized as needed to contain the result. More...
template<class CharOwningContainer , class... Args>
csubstr	c4::catrs_append (CharOwningContainer *cont, Args const &...args)
	cat+resize+append: like c4::cat(), but receives a container, and appends to it instead of overwriting it. More...

Detailed Description

Function Documentation

cat()

template<class Arg , class... Args>

size_t c4::cat	(	substr	buf,
		Arg const &	a,
		Args const &...	more
	)

serialize the arguments, concatenating them to the given fixed-size buffer.

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::catrs() if instead of a fixed-size buffer, a resizeable container is desired

c4::uncat() for the inverse function

c4::catsep() if a separator between each argument is to be used

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

Definition at line 593 of file format.hpp.

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

References c4::to_chars().

Referenced by c4::cat_sub(), c4::catrs(), c4::catrs_append(), and sample::sample_formatting().

cat_sub()

template<class... Args>

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

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

Definition at line 603 of file format.hpp.

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

References c4::cat().

Referenced by sample::sample_formatting().

catrs() [1/2]

template<class CharOwningContainer , class... Args>

void c4::catrs ( CharOwningContainer *  cont, Args const &...  args  )

inline

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

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

See also

c4::cat()

Definition at line 897 of file format.hpp.

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

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

Referenced by c4::catrs(), and sample::sample_formatting().

catrs() [2/2]

template<class CharOwningContainer , class... Args>

CharOwningContainer c4::catrs ( Args const &...  args )

inline

cat+resize: like c4::cat(), but creates and returns a new container sized as needed to contain the result.

See also

c4::cat()

Definition at line 912 of file format.hpp.

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

References c4::catrs().

catrs_append()

template<class CharOwningContainer , class... Args>

csubstr c4::catrs_append ( CharOwningContainer *  cont, Args const &...  args  )

inline

cat+resize+append: like c4::cat(), but receives a container, and appends to it instead of overwriting it.

The container is resized as needed to contain the result.

Returns

the region newly appended to the original container

See also

c4::cat()

c4::catrs()

Definition at line 928 of file format.hpp.

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

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

Referenced by sample::sample_formatting().