[#BloombergLP-bslfmt-PadUtil-pad-01]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslfmt.adoc[bslfmt]::xref:BloombergLP/bslfmt/PadUtil.adoc[PadUtil]::pad
:relfileprefix: ../../../
:mrdocs:

Write the specified `filler` (possibly a multi&hyphen;byte unicode sequence) to the specified `out` the specified `padWidth` times and return the new output iterator&period; If `padWidth &lt; 0`, no output is done&period; The behavior is undefined unless the character type of `filler` is the same as `t&lowbar;CHAR` or `filler` is entirely ascii&period; Note that the overloads that input a single character have an advantage over `bsl&colon;&colon;fill&lowbar;n` in that they will automatically widen or narrow the input character to `t&lowbar;CHAR` if necessary&period;

== Synopsis

Declared in `&lt;bslfmt&lowbar;padutil&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class t&lowbar;ITERATOR&gt;
static
t&lowbar;ITERATOR
pad(
    t&lowbar;ITERATOR out,
    std::ptrdiff&lowbar;t padWidth,
    std::string&lowbar;view const& filler);
----


[.small]#Created with https://www.mrdocs.com[MrDocs]#
