名前空間
変種
操作

std::time_get<CharT,InputIt>::get_weekday, std::time_get<CharT,InputIt>::do_get_weekday

提供: cppreference.com
< cpp‎ | locale‎ | time get
 
 
 
 
ヘッダ <locale> で定義
public:

iter_type get_weekday( 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_weekday( iter_type beg, iter_type end, std::ios_base& str,

                                  std::ios_base::iostate& err, std::tm* t) const;
(2)
1) public メンバ関数。 最も派生したクラスの protected virtual メンバ関数 do_get_weekday を呼びます。
2) シーケンス [beg, end) から連続する文字を読み込み、このロケールによって期待されるデフォルトの曜日の書式を用いて、 (省略形かもしれない) 曜日の名前を解析します。 デフォルトの書式は関数 std::get_timetime_get::get および POSIX の関数 strptime() によって使用される "%a" と同じ書式です。

省略形の名前が見つかり、その後に完全な名前として有効な文字が続く場合は、完全な名前の文字をすべて消費するか、期待と異なる文字が見つかるまで、読み込みを継続します。 期待と異なる文字が見つかった場合は、たとえ最初の何文字かが有効な省略形であったとしても、解析は失敗します。

解析した曜日は std::tm のフィールド t->tm_wday に格納されます。

有効な曜日の名前を読み込む前に終端イテレータに達した場合、この関数は errstd::ios_base::eofbit をセットします。 解析エラーに遭遇した場合、この関数は errstd::ios_base::failbit をセットします。

目次

[編集] 引数

beg - 解析するシーケンスの開始を指定するイテレータ
end - 解析するシーケンスの終端イテレータ
str - 必要なときにロケールのファセットを取得するためにこの関数が使用するストリームオブジェクト (例えばホワイトスペースをスキップするための std::ctype や文字列を比較するための std::collate)
err - エラーを示すためにこの関数によって変更されるストリームエラーフラグオブジェクト
t - この関数呼び出しの結果を保持する std::tm オブジェクトへのポインタ

[編集] 戻り値

有効な曜日の一部として認識された [beg, end) 内の最後の文字の次を指すイテレータ。

[編集] ノート

この関数は通常、大文字小文字を区別しません。

解析エラーに遭遇した場合、この関数のほとんどの実装は *t を変更しません。

[編集]

#include <iostream>
#include <locale>
#include <sstream>
#include <iterator>
 
void try_get_wday(const std::string& s)
{
    std::cout << "Parsing the weekday out of '" << s <<
                 "' in the locale " << std::locale().name() << '\n';
    std::istringstream str(s);
    std::ios_base::iostate err = std::ios_base::goodbit;
 
    std::tm t;
    std::istreambuf_iterator<char> ret =
        std::use_facet<std::time_get<char>>(str.getloc()).get_weekday(
            {str}, {}, str, err, &t
        );
    str.setstate(err);
    std::istreambuf_iterator<char> last{};
    if(str) {
        std::cout << "Successfully parsed, weekday number is " << t.tm_wday;
        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()
{
    std::locale::global(std::locale("lt_LT.utf8"));
    try_get_wday("Št");
    try_get_wday("Šeštadienis");
 
    std::locale::global(std::locale("en_US.utf8"));
    try_get_wday("SATELLITE");
 
    std::locale::global(std::locale("ja_JP.utf8"));
    try_get_wday("土曜日");
}

出力:

Parsing the weekday out of 'Št' in the locale lt_LT.utf8
Successfully parsed, weekday number is 6 the input was fully consumed
Parsing the weekday out of 'Šeštadienis' in the locale lt_LT.utf8
Successfully parsed, weekday number is 6 the input was fully consumed
Parsing the weekday out of 'SATELLITE' in the locale en_US.utf8
Successfully parsed, weekday number is 6 Remaining content: ELLITE
Parsing the weekday out of '土曜日' in the locale ja_JP.utf8
Successfully parsed, weekday number is 6 the input was fully consumed

[編集] 関連項目

(C++11)
指定された書式の日付/時刻の値をパースします
(関数テンプレート) [edit]