cpp/locale/time put/put

Converts the calendar date and time stored in the std object pointed to by into a character string, according to the format string. The format string is the same as used by, but each format specifier is processed by an individual call to , which can be customized by extending this facet.

@1@ Steps through the character sequence, examining the characters. Every character that is not a part of a format sequence is written to the output iterator immediately. To identify format sequences, this function narrows the next character in  as if by  and if it equals, the next one or two characters are compared to the list of format sequences recognized by std plus any additional implementation-defined formats supported by this locale. For each valid format sequence, a call to is made, where  is the format sequence character, and  is the optional format sequence modifier ( or ). A value of is used if the modifier is absent. @2@ Calls the member function of the most derived class. @3@ Converts the calendar date and time stored in the std object pointed to by into a character string, according to the format conversion sequence formed by concatenating, the value of  if not , and the value of. The format is interpreted the same way as the function std, except that the formats that are described as locale-dependent are defined by this locale, and additional format specifiers may be supported (the argument is provided for these implementation-defined format specifiers to use). The string is written to the output iterator.

Return value
Iterator pointing one past the last character that was produced.