std::setlocale

namespace std {
  char* setlocale(int category, const char* locale);
}

概要

指定したカテゴリのロケールを設定、または現在のロケールを取得する。

指定できる処理系定義のロケール文字列は使用できるロケール文字列を参照のこと。

この関数の呼び出しは他スレッドにおける setlocale() または現在のロケールを使用する他の関数の呼び出しとデータ競合の可能性がある。

プログラム開始時の現在のロケールは std::setlocale(LC_ALL, "C"); が呼び出されたのと同じ状態に初期化される。

引数

• category：設定対象のカテゴリ。LC_ALL,LC_CTYPEなどのマクロを使用。
• locale：
  • "C"：標準のCロケール
  • ""：環境依存のデフォルトロケール
  • NULL：現在のロケールを取得するだけ
  • 処置系定義の文字列

戻り値

成功時は設定されたロケール名（文字列）、失敗時はNULL。

返された文字列をプログラムで変更してはならない。

setlocale() を呼び出したスレッドが終了した後、もしくは更に次の setlocale() の呼び出しの後に返された文字列を使った時の動作は未定義である。

例

#include <iostream>
#include <clocale>

int main() {
  // 日本語ロケールに設定
  if (!std::setlocale(LC_ALL, "ja_JP.UTF-8")) {
    std::cerr << "Failed to set locale\n";
    return 1;
  }

  // 現在の全カテゴリのロケールを取得
  std::cout << "Current locale: " << std::setlocale(LC_ALL, NULL) << "\n";

  // 数値カテゴリだけ確認
  std::cout << "Numeric locale: " << std::setlocale(LC_NUMERIC, NULL) << "\n";
}

出力

Current locale: ja_JP.UTF-8
Numeric locale: ja_JP.UTF-8

関連項目

• ロケール文字列一覧
• std::locale