std::time_get<CharT,InputIt>:: get_weekday, std::time_get<CharT,InputIt>:: do_get_weekday
|
ヘッダー
<locale>
で定義
|
||
|
public
:
iter_type get_weekday
(
iter_type beg, iter_type end,
std::
ios_base
&
str,
|
(1) | |
|
protected
:
virtual
iter_type do_get_weekday
(
iter_type beg, iter_type end,
std::
ios_base
&
str,
|
(2) | |
do_get_weekday
を呼び出す。
[
beg
,
end
)
の範囲から曜日名(省略形も可)を解析する。このロケールが期待するデフォルトの曜日フォーマットを使用する。これは、
"%a"
と同じフォーマットであり、
std::get_time
、
time_get::get
関数、およびPOSIX関数
strptime()
で使用されるものと同じである。
省略名が見つかり、その後ろに完全名として有効な文字が続く場合、完全名のすべての文字を消費するか、予期しない文字を見つけるまで読み取りを続けます。後者の場合、最初の数文字が有効な省略形であっても解析は失敗します。
解析された曜日は、 std::tm フィールド t - > tm_wday に格納されます。
有効な曜日名が読み取られる前に終端イテレータに到達した場合、関数は 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 <initializer_list> #include <iostream> #include <iterator> #include <locale> #include <sstream> #include <string_view> void try_get_wday(std::string_view s) { std::cout << "ロケール " << std::locale().name() << " で '" << s << "' から曜日を解析中\n"; std::istringstream str{s.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_weekday({str}, {}, str, err, &t); str.setstate(err); std::istreambuf_iterator<char> last{}; if (str) { std::cout << "解析成功、曜日番号は " << t.tm_wday; if (ret != last) { std::cout << " 残りの内容: "; std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout)); } else std::cout << " 入力は完全に消費されました"; } else { std::cout << "解析失敗。未解析の文字列: "; std::copy(ret, last, std::ostreambuf_iterator<char>(std::cout)); } std::cout << '\n'; } void demo(std::string_view locale_name, std::initializer_list<std::string_view>&& data) { try { std::locale::global(std::locale(locale_name.data())); } catch (std::runtime_error const& ex) { std::cout << "ロケールを設定できません: " << locale_name << "\n" "例外: " << ex.what() << '\n'; return; } for (std::string_view const weekday : data) try_get_wday(weekday); } int main() { demo("lt_LT.utf8", {"Št", "Šeštadienis"}); demo("en_US.utf8", {"SATELLITE"}); demo("ja_JP.utf8", {"土曜日"}); }
出力例:
ロケール lt_LT.utf8 における 'Št' からの曜日解析 正常に解析完了、曜日番号は6 入力は完全に消費されました ロケール lt_LT.utf8 における 'Šeštadienis' からの曜日解析 正常に解析完了、曜日番号は6 入力は完全に消費されました ロケール en_US.utf8 における 'SATELLITE' からの曜日解析 正常に解析完了、曜日番号は6 残りの内容: ELLITE ロケール ja_JP.utf8 における '土曜日' からの曜日解析 正常に解析完了、曜日番号は6 入力は完全に消費されました
不具合報告
以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。
| DR | 適用対象 | 公開時の動作 | 正しい動作 |
|---|---|---|---|
| LWG 248 | C++98 |
eofbit
が終端イテレータ到達時に設定されなかった
|
有効な曜日名が読み込まれなかった場合に
eofbit
を設定する
|
関連項目
|
(C++11)
|
指定されたフォーマットの日付/時刻値を解析する
(関数テンプレート) |