std::filesystem::path::c_str, std::filesystem::path::native, std::filesystem::path::operator string_type()

< cpp‎ | filesystem‎ | path
 
C++
 
文件系统库
类
函数
文件类型
 
std::filesystem::path
常量
成员函数
路径分解
非成员函数
(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20)
 
const value_type* c_str() const noexcept;
 (1) (C++17 起)
const string_type& native() const noexcept;
 (2) (C++17 起)
operator string_type() const;
 (3) (C++17 起)

访问作为字符串的原生路径名。

1) 等价于 native().c_str() 。
2) 以引用返回路径名的原生格式表示。
3) 以值返回路径名的原生格式表示。

参数

（无）

返回值

路径名的原生格式表示，使用原生语法、原生字符类型，及原生字符编码。此字符串适用于 OS API 。

注意

提供转换函数 (3) 以令接受 std::basic_string 文件名的 API 能使用路径名而无需更改代码。

示例

运行此代码
#include <cstdio>
#ifdef _MSC_VER
#include <io.h>
#include <fcntl.h>
#else
#include <locale>
#include <clocale>
#endif
#include <fstream>
#include <iostream>
#include <filesystem>
namespace fs = std::filesystem;
 
int main()
{
#ifdef _MSC_VER
    _setmode(_fileno(stderr), _O_WTEXT);
#else
    std::setlocale(LC_ALL, "");
    std::locale::global(std::locale(""));
    std::cout.imbue(std::locale());
    std::wcerr.imbue(std::locale());
#endif
 
    fs::path p = fs::u8path(u8"要らない.txt");
    std::ofstream(p) << "File contents"; // 在 LWG2676 前 MSVC 上使用 operator string_type()
                                         // ，其中 string_type 是 wstring ，仅根据非标准扩展工作
                                         // LWG2676 后使用新的 fstream 构造函数
 
    // 原生字符串表示可用于 OS API
    if (std::FILE* f =
#ifdef _MSC_VER
                _wfopen(p.c_str(), L"r")
#else
                std::fopen(p.c_str(), "r")
#endif
        )
    {
        int ch;
        while((ch=fgetc(f))!= EOF) putchar(ch);
        std::fclose(f);
    }
 
    // 多字节与宽字节表示可用于输出
    std::cout << "\nFile name in narrow multibyte encoding: " << p.string() << '\n';
    std::wcerr << "File name in wide encoding: " << p.wstring() << '\n';
 
    fs::remove(p);
}

输出： 

File contents
File name in narrow multibyte encoding: 要らない.txt
File name in wide encoding: 要らない.txt

参阅

 返回转换到字符串的原生路径名格式
(公开成员函数)
返回转换到字符串的通用路径名格式
(公开成员函数)