std::time_get<CharT,InputIt>::get_monthname, std::time_get<CharT,InputIt>::do_get_monthname

Определено в заголовке <locale>

Определено в заголовке `<locale>`
public: iter_type get_monthname( iter_type beg, iter_type end, std::ios_base& str, std::ios_base::iostate& err, std::tm* t ) const;	(1)
protected: virtual iter_type do_get_monthname( iter_type beg, iter_type end, std::ios_base& str, std::ios_base::iostate& err, std::tm* t ) const;	(2)

public:
iter_type get_monthname( iter_type beg, iter_type end, std::ios_base& str,
                         std::ios_base::iostate& err, std::tm* t ) const;

(1)

protected:
virtual iter_type do_get_monthname( iter_type beg, iter_type end, std::ios_base& str,
                                    std::ios_base::iostate& err, std::tm* t ) const;

(2)

1) Публичный член-функция, вызывает защищенную виртуальную член-функцию do_get_monthname самого производного класса.

2) Считывает последовательные символы из последовательности [beg, end) и анализирует имя месяца (возможно, сокращенное), используя формат имен месяцев по умолчанию для текущего региона, который совпадает с форматом "%b" , используемым функциями std::get_time, time_get::get и функцией POSIX strptime().

Если она находит сокращенное имя, за которым следуют символы, допустимые для полного имени, она продолжает чтение, пока не прочитает все символы полного имени или не найдет символ, который не ожидается, в этом случае анализ завершается неудачей, даже если первые несколько символов были допустимым сокращением.

Прочитанный месяц хранится в поле std::tm t->tm_mon.

Если конец итератора достигнут до того, как будет прочитано допустимое имя месяца, функция устанавливает std::ios_base::eofbit в err. Если возникает ошибка анализа, функция устанавливает std::ios_base::failbit в err.

Параметры

beg	-	Итератор, обозначающий начало последовательности для анализа
end	-	Итератор, следующий за концом последовательности для анализа
str	-	Объект потока, который эта функция использует для получения аспектов локали при необходимости, например, `std::ctype` для пропуска пробелов или `std::collate` для сравнения строк
err	-	Объект флагов ошибок потока, который изменяется этой функцией для указания ошибок
t	-	Указатель на объект `std::tm`, который будет содержать результат этого вызова функции

Возвращаемое значение

Итератор, указывающий на символ, следующий за последним символом в [beg, end), который был распознан как часть допустимого имени месяца.

Примечания

Эта функция обычно нечувствительна к регистру.

Если возникает ошибка анализа, большинство реализаций этой функции оставляют *t неизменным.

Пример

#include <ctime>
#include <iostream>
#include <iterator>
#include <locale>
#include <sstream>
#include <string_view>
 
void try_get_mon(std::string_view locale_name, std::string_view source)
{
    try
    {
        std::locale::global(std::locale(locale_name.data()));
    }
    catch (std::runtime_error const& ex)
    {
        std::cout << "Cannot setup locale: " << locale_name << "\n"
                     "Exception: " << ex.what() << '\n';
        return;
    }
 
    std::cout << "Parsing the month out of '" << source
              << "' in the locale " << std::locale().name() << '\n';
    std::istringstream str{source.data()};
    std::ios_base::iostate err = std::ios_base::goodbit;
 
    std::tm t;
    std::time_get<char> const& facet = std::use_facet<std::time_get<char>>(str.getloc());
    std::istreambuf_iterator<char> ret = facet.get_monthname({str}, {}, str, err, &t);
    str.setstate(err);
    std::istreambuf_iterator<char> last{};
 
    if (str)
    {
        std::cout << "Successfully parsed, month number is " << t.tm_mon;
 
        if (ret != last)
        {
            std::cout << ". Remaining content: ";
            std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout));
        }
        else
            std::cout << ". The input was fully consumed";
    }
    else
    {
        std::cout << "Parse failed. Unparsed string: ";
        std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout));
    }
 
    std::cout << '\n';
}
 
int main()
{
    try_get_mon("ja_JP.utf8", "2月");
    try_get_mon("th_TH.utf8", "กุมภาพันธ์");
    try_get_mon("el_GR.utf8", "Φεβ");
    try_get_mon("el_GR.utf8", "Φεβρουάριος");
    try_get_mon("en_US.utf8", "Febrile");
}

Возможный вывод:

Parsing the month out of '2月' in the locale ja_JP.utf8
Successfully parsed, month number is 1. The input was fully consumed
Parsing the month out of 'กุมภาพันธ์' in the locale th_TH.utf8
Successfully parsed, month number is 1. The input was fully consumed
Parsing the month out of 'Φεβ' in the locale el_GR.utf8
Successfully parsed, month number is 1. The input was fully consumed
Parsing the month out of 'Φεβρουάριος' in the locale el_GR.utf8
Successfully parsed, month number is 1. The input was fully consumed
Parsing the month out of 'Febrile' in the locale en_US.utf8
Parse failed. Unparsed string: ile

Отчеты об ошибках

Следующие отчеты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

DR	Применимо к	Поведение, как опубликовано	Корректное поведение
LWG 248	C++98	`eofbit` не устанавливался при достижении конечного итератора	Устанавливает `eofbit`, если не было прочитано допустимое имя месяца

См. также

get_time

(C++11)

парсит значение даты/времени указанного формата
(шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/locale/time_get/get_monthname