std::experimental::filesystem::current_path

< cpp‎ | experimental‎ | fs
在标头 <experimental/filesystem> 定义
path current_path();
(1) (文件系统 TS)
path current_path( error_code& ec );
(2) (文件系统 TS)
void current_path( const path& p );
(3) (文件系统 TS)
void current_path( const path& p, error_code& ec );
(4) (文件系统 TS)

返回或改变当前路径。

1,2) 返回当前工作目录的绝对路径,如同以 POSIX getcwd 获得。当发生错误时 (2) 返回 path()
3,4) 改变当前工作目录为 p,如同通过调用 POSIX chdir

参数

p - 要将当前工作目录改为的路径
ec - 用于无抛出重载中报告错误的输出形参

返回值

1,2) 返回当前工作目录。
3,4) (无)

异常

1,2) 不接受 error_code& 形参的重载,在发生底层 OS API 错误时抛出 filesystem_error,它以 以 OS 错误码为错误码实参构造。如果内存分配失败,则可抛出 std::bad_alloc。接受 error_code& 形参的重载,当 OS API 调用失败时将之设置为 OS API 错误码,而未发生错误时执行 ec.clear()。此重载具有
noexcept 规定:  
noexcept
  
3,4) 不接受 error_code& 形参的重载,在发生底层 OS API 错误时抛出 filesystem_error,它以 p 为第一实参并以 OS 错误码为错误码实参构造。如果内存分配失败,则可抛出 std::bad_alloc。接受 error_code& 形参的重载,当 OS API 调用失败时将之设置为 OS API 错误码,而未发生错误时执行 ec.clear()。此重载具有
noexcept 规定:  
noexcept
  

注解

当前工作目录是在相对路径的路径解析中用作起始位置的目录。整个进程与一个当前工作目录相关联。

当前工作目录是一项危险的程序全局状态。各种文件输入/输出相关函数的行为都收到当前路径的值影响。当前路径可能被程序的任何组分非预期地改变,包括各种外部库或其他线程。

参阅