make_preferred.md

make_preferred

• filesystem[meta header]
• std::filesystem[meta namespace]
• path[meta class]
• function[meta id-type]
• cpp17[meta cpp]

path& make_preferred();

概要

ディレクトリの区切り文字を推奨する形式に変換する。

この関数は、環境非依存のディレクトリ区切り文字を、その環境 (OS) が推奨する形式に変換する。環境非依存のディレクトリ区切り文字として "/" (スラッシュ) があるが、例としてWindows環境では "\\" (バックスラッシュ) が推奨されるディレクトリ区切り文字となっている。

環境が推奨するディレクトリ区切り文字は、このクラスのメンバ定数preferred_separatorで取得できる。

戻り値

*this

例

POSIXベースシステムでの例

#include <iostream>
#include <filesystem>

namespace fs = std::filesystem;

int main()
{
  // POSIX環境では推奨のディレクトリ区切り文字が "/" (スラッシュ)。
  // 環境非依存のディレクトリ区切り文字 "/" から変更がないため、この関数はなにもしない
  fs::path p = "foo/bar";
  p.make_preferred();

  std::cout << p << std::endl;
}

• make_preferred()[color ff0000]

出力

"foo/bar"

Windowsでの例

#include <iostream>
#include <filesystem>

namespace fs = std::filesystem;

int main()
{
  // Windows環境では推奨のディレクトリ区切り文字が "\\" (バックスラッシュ)。
  // 環境非依存のディレクトリ区切り文字 "/" が "\\" に変換される
  fs::path p = "foo/bar";
  p.make_preferred();

  std::cout << p << std::endl;
}

• make_preferred()[color ff0000]

出力

"foo\\bar"

バージョン

言語

• C++17

処理系

• Clang:
• GCC: 8.1 [mark verified]
• Visual C++: 2017 Update 7 [mark verified]