Write padWidth copies of a single‐character filler through out.

Synopsis

Declared in <bslfmt_padutil.h>

template<class t_ITERATOR>
static
t_ITERATOR
pad(
    t_ITERATOR out,
    std::ptrdiff_t padWidth,
    char filler);

Return Value

the output iterator after writing the filler repetitions

Parameters

Name

Description

out

output iterator receiving the filler repetitions

padWidth

number of times to write filler; no output if < 0

filler

single character written as each padding unit

Created with MrDocs