[locale.time.put.members]

# 28 Text processing library [[text]](./#text)

## 28.3 Localization library [[localization]](localization#locale.time.put.members)

### 28.3.4 Standard locale categories [[locale.categories]](locale.categories#locale.time.put.members)

#### 28.3.4.6 The time category [[category.time]](category.time#locale.time.put.members)

#### 28.3.4.6.4 Class template time_put [[locale.time.put]](locale.time.put#members)

#### 28.3.4.6.4.2 Members [locale.time.put.members]

[🔗](#lib:time_put,put)

`iter_type put(iter_type s, ios_base& str, char_type fill, const tm* t,
              const charT* pattern, const charT* pat_end) const;
iter_type put(iter_type s, ios_base& str, char_type fill, const tm* t,
              char format, char modifier = 0) const;
`

[1](#1)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L4008)

*Effects*: The first form steps through the sequence
from pattern to pat_end,
identifying characters that are part of a format sequence[.](#1.sentence-1)

Each character that is not part of a format sequence
is written to s immediately, and
each format sequence, as it is identified, results in a call to do_put;
thus, format elements and other characters are interleaved in the output
in the order in which they appear in the pattern[.](#1.sentence-2)

Format sequences are identified by converting each character c to
a char value as if by ct.narrow(c, 0),
where ct is a reference to ctype<charT> obtained from str.getloc()[.](#1.sentence-3)

The first character of each sequence is equal to '%',
followed by an optional modifier character mod and a format specifier character spec as defined for the function strftime[.](#1.sentence-4)

If no modifier character is present, mod is zero[.](#1.sentence-5)

For each valid format sequence identified,
calls do_put(s, str, fill, t, spec, mod)[.](#1.sentence-6)

[2](#2)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L4030)

The second form calls do_put(s, str, fill, t, format, modifier)[.](#2.sentence-1)

[3](#3)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L4033)

[*Note [1](#note-1)*:

The fill argument can be used
in the implementation-defined formats or by derivations[.](#3.sentence-1)

A space character is a reasonable default for this argument[.](#3.sentence-2)

— *end note*]

[4](#4)

[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/text.tex#L4040)

*Returns*: An iterator pointing immediately after the last character produced[.](#4.sentence-1)