boost 文件系统

时间  2019-11-11
标签 boost 文件 系统 栏目 C&C++ 繁體版
原文   原文链接

第 9 章 文件系统

目录

 该书采用 Creative Commons License 受权php

9.1. 概述

库 Boost.Filesystem 简化了处理文件和目录的工做。 它提供了一个名为 boost::filesystem::path 的类，能够对路径进行处理。 另外，还有多个函数用于建立目录或验证某个给定文件的有效性。html

9.2. 路径

boost::filesystem::path 是 Boost.Filesystem 中的核心类，它表示路径的信息，并提供了处理路径的方法。ios

实际上，boost::filesystem::path 是 boost::filesystem::basic_path<std::string> 的一个 typedef。 此外还有一个 boost::filesystem::wpath 是boost::filesystem::basic_path<std::wstring> 的 typedef。windows

全部定义均位于 boost::filesystem 名字空间，定义于 boost/filesystem.hpp 中。框架

能够经过传入一个字符串至 boost::filesystem::path 类来构建一个路径。函数

#include <boost/filesystem.hpp> 

int main() 
{ 
  boost::filesystem::path p1("C:\\"); 
  boost::filesystem::path p2("C:\\Windows"); 
  boost::filesystem::path p3("C:\\Program Files"); 
}

没有一个 boost::filesystem::path 的构造函数会实际验证所提供路径的有效性，或检查给定的文件或目录是否存在。 所以，boost::filesystem::path 甚至能够用无心义的路径来初始化。ui

#include <boost/filesystem.hpp> 

int main() 
{ 
  boost::filesystem::path p1("..."); 
  boost::filesystem::path p2("\\"); 
  boost::filesystem::path p3("@:"); 
}

以上程序能够执行的缘由是，路径其实只是字符串而已。 boost::filesystem::path 只是处理字符串罢了；文件系统没有被访问到。this

boost::filesystem::path 特别提供了一些方法来以字符串方式获取一个路径。 有趣的是，有三种不一样的方法。编码

#include <boost/filesystem.hpp> 
#include <iostream> 

int main() 
{ 
  boost::filesystem::path p("C:\\Windows\\System"); 
  std::cout << p.string() << std::endl; 
  std::cout << p.file_string() << std::endl; 
  std::cout << p.directory_string() << std::endl; 
}

string() 方法返回一个所谓的可移植路径。 换句话说，就是 Boost.Filesystem 用它本身预约义的规则来正规化给定的字符串。 在以上例子中，string() 返回 C:/Windows/System。 如你所见，Boost.Filesystem 内部使用斜杠符 / 做为文件名与目录名的分隔符。spa

可移植路径的目的是在不一样的平台，如 Windows 或 Linux 之间，惟一地标识文件和目录。 所以就再也不须要使用预处理器宏来根据底层的操做系统进行路径的编码。 构建可移植路径的规则大多符合POSIX标准，在 Boost.Filesystem 参考手册 给出。

请注意，boost::filesystem::path 的构造函数同时支持可移植路径和平台相关路径。 在上面例子中所使用的路径 "C:\\Windows\\System" 就不是可移植路径，而是 Windows 专用的。 它能够被 Boost.Filesystem 正确识别，但仅当该程序是在 Windows 操做系统下运行的时候！ 当程序运行于一个 POSIX 兼容的操做系统，如 Linux 时，string() 将返回 C:\Windows\System。 由于在 Linux 中，反斜杠符 \ 并不被用做分隔符，不管是可移植格式或原生格式，Boost.Filesystem 都不会认为它是文件和目录的分隔符。

不少时候，都不能避免使用平台相关路径做为字符串。 一个例子就是，使用操做系统函数时必需要用平台相关的编码。 方法 file_string() 和 directory_string() 正是为此目的而提供的。

在上例中，这两个方法都会返回 C:\Windows\System - 与底层操做系统无关。 在 Windows 上这个字符串是有效路径，而在一个 Linux 系统上则既不是可移植路径也不是平台相关路径，会象前面所说那样被解析。

如下例子使用一个可移植路径来初始化 boost::filesystem::path。

#include <boost/filesystem.hpp> 
#include <iostream> 

int main() 
{ 
  boost::filesystem::path p("/"); 
  std::cout << p.string() << std::endl; 
  std::cout << p.file_string() << std::endl; 
  std::cout << p.directory_string() << std::endl; 
}

因为 string() 返回的是一个可移植路径，因此它与用于初始化 boost::filesystem::path 的字符串相同：/。 可是 file_string() 和 directory_string() 方法则会因底层平台而返回不一样的结果。 在 Windows 中，它们都返回 \，而在 Linux 中则都返回 /。

你可能会奇怪为何会有两个不一样的方法用来返回平台相关路径。 到目前为止，在所看到的例子中，file_string() 和 directory_string() 都是返回相同的值。 可是，有些操做系统可能会返回不一样的结果。 由于 Boost.Filesystem 的目标是支持尽量多的操做系统，因此它提供了两个方法来适应这种状况。 即便你可能更为熟悉 Windows 或 POSIX 系统如 Linux，但仍是建议使用file_string() 来取出文件的路径信息，且使用 directory_string() 取出目录的路径信息。 这无疑会增长代码的可移植性。

boost::filesystem::path 提供了几个方法来访问一个路径中的特定组件。

#include <boost/filesystem.hpp> 
#include <iostream> 

int main() 
{ 
  boost::filesystem::path p("C:\\Windows\\System"); 
  std::cout << p.root_name() << std::endl; 
  std::cout << p.root_directory() << std::endl; 
  std::cout << p.root_path() << std::endl; 
  std::cout << p.relative_path() << std::endl; 
  std::cout << p.parent_path() << std::endl; 
  std::cout << p.filename() << std::endl; 
}

若是在是一个 Windows 操做系统上执行，则字符串 "C:\\Windows\\System" 被解释为一个平台相关的路径信息。 所以，root_name() 返回 C:, root_directory() 返回 /, root_path() 返回C:/, relative_path() 返回 Windows/System, parent_path() 返回 C:/Windows, 而 filename() 返回 System。

如你所见，没有平台相关的路径信息被返回。 没有一个返回值包含反斜杠 \，只有斜杠 /。 若是须要平台相关信息，则要使用 file_string() 或 directory_string()。 为了使用这些路径中的单独组件，必须建立一个类型为 boost::filesystem::path 的新对象并相应的进行初始化。

若是以上程序在 Linux 操做系统中执行，则返回值有所不一样。 多数方法会返回一个空字符串，除了 relative_path() 和 filename() 会返回 C:\Windows\System。 字符串 "C:\\Windows\\System" 在 Linux 中被解释为一个文件名，这个字符串既不是某个路径的可移植编码，也不是一个被 Linux 支持的平台相关编码。 所以，Boost.Filesystem 没有其它选择，只能将整个字符串解释为一个文件名。

Boost.Filesystem 还提供了其它方法来检查一个路径中是否包含某个特定子串。 这些方法是：has_root_name(), has_root_directory(), has_root_path(), has_relative_path(),has_parent_path() 和 has_filename()。 各个方法都是返回一个 bool 类型的值。

还有两个方法用于将一个文件名拆分为各个组件。 它们应当仅在 has_filename() 返回 true 时使用。 不然只会返回一个空字符串，由于若是没有文件名就没什么可拆分了。

#include <boost/filesystem.hpp> 
#include <iostream> 

int main() 
{ 
  boost::filesystem::path p("photo.jpg"); 
  std::cout << p.stem() << std::endl; 
  std::cout << p.extension() << std::endl; 
}

这个程序分别返回 photo 给 stem()，以及 .jpg 给 extension()。

除了使用各个方法调用来访问路径的各个组件之外，你还能够对组件自己进行迭代。

#include <boost/filesystem.hpp> 
#include <iostream> 

int main() 
{ 
  boost::filesystem::path p("C:\\Windows\\System"); 
  for (boost::filesystem::path::iterator it = p.begin(); it != p.end(); ++it) 
    std::cout << *it << std::endl; 
}

若是是在 Windows 上执行，则该程序将相继输出 C:, /, Windows 和 System。 在其它的操做系统如 Linux 上，输出结果则是 C:\Windows\System。

前面的例子示范了不一样的方法来访问路径中的各个组件，如下例子则示范了修改路径信息的方法。

#include <boost/filesystem.hpp> 
#include <iostream> 

int main() 
{ 
  boost::filesystem::path p("C:\\"); 
  p /= "Windows\\System"; 
  std::cout << p.string() << std::endl; 
}

经过使用重载的 operator/=() 操做符，这个例子将一个路径添加到另外一个之上。 在 Windows 中，该程序将输出 C:\Windows\System。 在 Linux 中，输出将会是 C:\/Windows\System，由于斜杠符 / 是文件与目录的分隔符。 这也是重载 operator/=() 操做符的缘由：毕竟，斜杠是这个方法名的一个部分。

除了 operator/=()，Boost.Filesystem 只提供了 remove_filename() 和 replace_extension() 方法来修改路径信息。

9.3. 文件与目录

boost::filesystem::path 的各个方法内部其实只是对字符串进行处理。 它们能够用来访问一个路径的各个组件、相互添加路径等等。

为了处理硬盘上的物理文件和目录，提供了几个独立的函数。 这些函数须要一个或多个 boost::filesystem::path 类型的参数，而且在其内部会调用操做系统功能来处理这些文件或目录。

在介绍各个函数以前，很重要的一点是要弄明白出现错误时会发生什么。 全部要在内部访问操做系统功能的函数都有可能失败。 在失败的状况下，将抛出一个类型为boost::filesystem::filesystem_error 的异常。 这个类是派生自 boost::system::system_error 的，所以适用于 Boost.System 框架。

除了继承自父类 boost::system::system_error 的 what() 和 code() 方法之外，还有另外两个方法：path1() 和 path2()。 它们均返回一个类型为 boost::filesystem::path 的对象，所以在发生错误时能够很容易地肯定路径信息 - 即便是对那些须要两个 boost::filesystem::path 参数的函数。

多数函数存在两个变体：在失败时，一个会抛出类型为 boost::filesystem::filesystem_error 的异常，而另外一个则返回类型为 boost::system::error_code 的对象。 对于后者，须要对返回值进行明确的检查以肯定是否出错。

如下例子介绍了一个函数，它能够查询一个文件或目录的状态。

#include <boost/filesystem.hpp> 
#include <iostream> 

int main() 
{ 
  boost::filesystem::path p("C:\\"); 
  try 
  { 
    boost::filesystem::file_status s = boost::filesystem::status(p); 
    std::cout << boost::filesystem::is_directory(s) << std::endl; 
  } 
  catch (boost::filesystem::filesystem_error &e) 
  { 
    std::cerr << e.what() << std::endl; 
  } 
}

boost::filesystem::status() 返回一个 boost::filesystem::file_status 类型的对象，该对象能够被传递给其它辅助函数来评估。 例如，若是查询的是一个目录的状态，则boost::filesystem::is_directory() 将返回 true。 除了 boost::filesystem::is_directory()，还有其它函数，如 boost::filesystem::is_regular_file(), boost::filesystem::is_symlink()和 boost::filesystem::exists()，它们都会返回一个 bool 类型的值。

除了 boost::filesystem::status()，另外一个名为 boost::filesystem::symlink_status() 的函数可用于查询一个符号连接的状态。 在此状况下，实际上查询的是符号连接所指向的文件的状态。在 Windows 中，符号连接以 lnk 文件扩展名识别。

另有一组函数可用于查询文件和目录的属性。

#include <boost/filesystem.hpp> 
#include <iostream> 

int main() 
{ 
  boost::filesystem::path p("C:\\Windows\\win.ini"); 
  try 
  { 
    std::cout << boost::filesystem::file_size(p) << std::endl; 
  } 
  catch (boost::filesystem::filesystem_error &e) 
  { 
    std::cerr << e.what() << std::endl; 
  } 
}

函数 boost::filesystem::file_size() 以字节数返回一个文件的大小。

#include <boost/filesystem.hpp> 
#include <iostream> 
#include <ctime> 

int main() 
{ 
  boost::filesystem::path p("C:\\Windows\\win.ini"); 
  try 
  { 
    std::time_t t = boost::filesystem::last_write_time(p); 
    std::cout << std::ctime(&t) << std::endl; 
  } 
  catch (boost::filesystem::filesystem_error &e) 
  { 
    std::cerr << e.what() << std::endl; 
  } 
}

要得到一个文件最后被修改的时间，可以使用 boost::filesystem::last_write_time()。

#include <boost/filesystem.hpp> 
#include <iostream> 

int main() 
{ 
  boost::filesystem::path p("C:\\"); 
  try 
  { 
    boost::filesystem::space_info s = boost::filesystem::space(p); 
    std::cout << s.capacity << std::endl; 
    std::cout << s.free << std::endl; 
    std::cout << s.available << std::endl; 
  } 
  catch (boost::filesystem::filesystem_error &e) 
  { 
    std::cerr << e.what() << std::endl; 
  } 
}

boost::filesystem::space() 用于取回磁盘的总空间和剩余空间。 它返回一个 boost::filesystem::space_info 类型的对象，其中定义了三个公有属性：capacity, free 和 available。 这三个属性的类型均为 boost::uintmax_t，该类型定义于 Boost.Integer 库，一般是 unsigned long long 的 typedef。 磁盘空间是以字节数来计算的。

目前所看到的函数都不会触及文件和目录自己，不过有另外几个函数能够用于建立、更名或删除文件和目录。

#include <boost/filesystem.hpp> 
#include <iostream> 

int main() 
{ 
  boost::filesystem::path p("C:\\Test"); 
  try 
  { 
    if (boost::filesystem::create_directory(p)) 
    { 
      boost::filesystem::rename(p, "C:\\Test2"); 
      boost::filesystem::remove("C:\\Test2"); 
    } 
  } 
  catch (boost::filesystem::filesystem_error &e) 
  { 
    std::cerr << e.what() << std::endl; 
  } 
}

以上例子应该是自解释的。 仔细察看，能够看到传递给各个函数的不必定是 boost::filesystem::path 类型的对象，也能够是一个简单的字符串。 这是能够的，由于 boost::filesystem::path提供了一个非显式的构造函数，能够从简单的字符串转换为 boost::filesystem::path 类型的对象。 这实际上简化了 Boost.Filesystem 的使用，由于能够无须显式建立一个对象。

还有其它的函数，如 create_symlink() 用于建立符号连接，以及 copy_file() 用于复制文件或目录。

如下例子中介绍了一个函数，基于一个文件名或一小节路径来建立一个绝对路径。

#include <boost/filesystem.hpp> 
#include <iostream> 

int main() 
{ 
  try 
  { 
    std::cout << boost::filesystem::complete("photo.jpg") << std::endl; 
  } 
  catch (boost::filesystem::filesystem_error &e) 
  { 
    std::cerr << e.what() << std::endl; 
  } 
}

输出哪一个路径是由该程序运行时所处的路径决定的。 例如，若是该例子从 C:\ 运行，输出将是 C:/photo.jpg。

请再次留意斜杠符 /! 若是想获得一个平台相关的路径，则须要初始化一个 boost::filesystem::path 类型的对象，且必须调用 file_string()。

要取出一个相对于其它目录的绝对路径，可将第二个参数传递给 boost::filesystem::complete()。

#include <boost/filesystem.hpp> 
#include <iostream> 

int main() 
{ 
  try 
  { 
    std::cout << boost::filesystem::complete("photo.jpg", "D:\\") << std::endl; 
  } 
  catch (boost::filesystem::filesystem_error &e) 
  { 
    std::cerr << e.what() << std::endl; 
  } 
}

如今，该程序显示的是 D:/photo.jpg。

最后，还有一个辅助函数用于取出当前工做目录，以下例所示。

#include <windows.h> 
#include <boost/filesystem.hpp> 
#include <iostream> 

int main() 
{ 
  try 
  { 
    std::cout << boost::filesystem::current_path() << std::endl; 
    SetCurrentDirectory("C:\\"); 
    std::cout << boost::filesystem::current_path() << std::endl; 
  } 
  catch (boost::filesystem::filesystem_error &e) 
  { 
    std::cerr << e.what() << std::endl; 
  } 
}

以上程序只能在 Windows 中执行，这是 SetCurrentDirectory() 函数的缘由。 这个函数更换了当前工做目录，所以对 boost::filesystem::current_path() 的两次调用将返回不一样的结果。

函数 boost::filesystem::initial_path() 用于返回应用程序开始执行时所处的目录。 可是，这个函数取决于操做系统的支持，所以若是须要可移植性，建议不要使用。 在这种状况下，Boost.Filesystem 文档中建议的方法是，能够在程序开始时保存 boost::filesystem::current_path() 的返回值，以备后用。

9.4. 文件流

C++ 标准在 fstream 头文件中定义了几个文件流。 这些流不能接受 boost::filesystem::path 类型的参数。 因为 Boost.Filesystem 库颇有可能被包含在 C++ 标准的 Technical Report 2 中，因此这些文件流将经过相应的构造函数来进行扩展。 为了当前可让文件流与类型为 boost::filesystem::path 的路径信息一块儿工做，可使用头文件 boost/filesystem/fstream.hpp。 它提供了对文件流所需的扩展，这些都是基于 Technical Report 2 即将加入 C++ 标准中的。

#include <boost/filesystem/fstream.hpp> 
#include <iostream> 

int main() 
{ 
  boost::filesystem::path p("test.txt"); 
  boost::filesystem::ofstream ofs(p); 
  ofs << "Hello, world!" << std::endl; 
}

不只是构造函数，还有 open() 方法也须要重载，以接受类型为 boost::filesystem::path 的参数。

9.5. 练习

You can buy solutions to all exercises in this book as a ZIP file.

  1. 建立一个程序，该程序为位于应用程序当前工做目录的上一层目录中的一个名为 data.txt 的文件建立一个绝对路径。 例如，若是该程序从 C:\Program Files\Test 执行，则应显示C:\Program Files\data.txt。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程