Alignment specifiers

Classes
struct	c4::fmt::left_< T >
struct	c4::fmt::center_< T >
struct	c4::fmt::right_< T >

Functions
template<class T >
left_< T >	c4::fmt::left (T val, size_t width, char padchar=' ')
	tag type to mark an argument to be aligned left. More...
template<class T >
center_< T >	c4::fmt::center (T val, size_t width, char padchar=' ')
	tag function to mark an argument to be aligned center More...
template<class T >
right_< T >	c4::fmt::right (T val, size_t width, char padchar=' ')
	tag function to mark an argument to be aligned right More...

Detailed Description

Function Documentation

template<class T >

left_<T> c4::fmt::left	(	T	val,
		size_t	width,
		char	padchar = ' '
	)

tag type to mark an argument to be aligned left.

Parameters

val	the argument to be aligned left
width	the length of the field
padchar	the padding character, defaults to ' '

Note

This function (and the return structure) uses value semantics. To avoid copies on larger types, you can use std::cref(). For example:

char buf[512];
std::string large_string = .....;
size_t len = cat(buf, fmt::left(std::cref(large_string), 100));

Definition at line 515 of file format.hpp.

Referenced by c4::basic_substring< char >::offs(), and sample_formatting().

{
    return left_<T>(val, width, padchar);
}

template<class T >

center_<T> c4::fmt::center	(	T	val,
		size_t	width,
		char	padchar = ' '
	)

tag function to mark an argument to be aligned center

Parameters

val	the argument to be aligned center
width	the length of the field
padchar	the padding character, defaults to ' '

Note

This function (and the return value) uses value semantics. To avoid copies on larger types, you can use std::cref(). For example:

char buf[512];
std::string large_string = .....;
size_t len = cat(buf, fmt::center(std::cref(large_string), 100));

Definition at line 534 of file format.hpp.

{
    return center_<T>(val, width, padchar);
}

template<class T >

right_<T> c4::fmt::right	(	T	val,
		size_t	width,
		char	padchar = ' '
	)

tag function to mark an argument to be aligned right

Parameters

val	the argument to be aligned right
width	the length of the field
padchar	the padding character, defaults to ' '

Note

This function (and the return value) uses value semantics. To avoid copies on larger types, you can use std::cref(). For example:

char buf[512];
std::string large_string = .....;
size_t len = cat(buf, fmt::right(std::cref(large_string), 100));

Definition at line 553 of file format.hpp.

Referenced by c4::basic_substring< char >::offs(), and sample_formatting().

{
    return right_<T>(val, width, padchar);
}