73 lines
2.6 KiB
Markdown
73 lines
2.6 KiB
Markdown
[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)
|