poco之文件系统
在Poco库中，封装了一些类去完成文件系统的操作，这些类包括：
1. Poco::Path
2. Poco::File
3. Poco::TemporaryFile
4. Poco::DirectoryIterator
5. Poco::Glob
1. Poco::Path
1.1 路径：
1. 在不同操作系统中，指明文件和目录所在位置的标示符是不一样的。2. 标示符的不一致，会造成代码在不同平台之间移植的困难。
3. Poco::Path类抽象了不同标识符之间的区别，使程序员可以把注意力集中在业务的开发上。
4. Poco::Path类支持Windows、Unix、OpenVMS操作系统。
1.2 Poco路径简介：
Poco中的路径包括了 ：1. 一个可选的节点(node)名:
a) 在Windows上，这是计算机在UNC( Universal Naming Convention )路径中的名字
b) 在OpenVMS中，这代表一个集群系统中的节点名
c) 在Unix中，此名字未被使用。
2. 一个可选的设备(device)名:
a) 在Windows上，这是一个驱动器盘符
b) 在OpenVMS上，这是存储盘符的名字
c) 在Unix，此名字未被使用。
3. 一个目录名的列表
4. 一个文件名(包括扩展名)和版本号(OpenVMS特有)
Poco支持两种路径 :
1. 绝对路径
以根目录为起点的描述资源的目录
2. 相对目录
以某一个确定路径为起点的描述资源的目录(通常这是用户的当前目录)
相对目录可以被转换为绝对目录(反之，并不成立)。
在Poco中路径的指向可以是一个目录也可以是一个文件。当路径指向目录时，文件名为空。
下面是Poco中关于路径的一些例子：
Path: C:\Windows\system32\cmd.exe
Style: Windows
Kind: absolute, to file
Node Name: –
Device Name: C
Directory List: Windows, system32
File Name: cmd.exe
File Version: –
Path: Poco\Foundation\
Style: Windows
Kind: relative, to directory
Node Name: –
Device Name: –
Directory List: Poco, Foundation
File Name: –
File Version: –
Path: \\www\site\index.html
Style: Windows
Kind: absolute, to file
Node Name: www
Device Name: –
Directory List: site
File Name: index.html
File Version: –
Path: /usr/local/include/Poco/Foundation.h
Style: Unix
Kind: absolute, to file
Node Name: –
Device Name: –
Directory List: usr, local, include, Poco
File Name: index.html
File Version: –
Path: ../bin/
Style: Unix
Kind: relative, to directory
Node Name: –
Device Name: –
Directory List: .., bin
File Name: –
File Version: –
Path: VMS001::DSK001:[POCO.INCLUDE.POCO]POCO.H;2
Style: OpenVMS
Kind: absolute, to file
Node Name: VMS001
Device Name: DSK001
Directory List: POCO, INCLUDE, POCO
File Name: POCO.H
File Version: 21.3 类说明
1. Poco::Path类在Poco库中代表了路径。2. Poco::Path类并不关心路径所指向的目标在文件系统中是否存在。这个工作由Poco::File类负责。
3. Poco::Path支持值语义(copy函数和赋值函数)，但不支持关系操作符。
构建一个路径
构建一个路径存在着两种方式：
1. 从0开始构建，分别构建node、device、directory、file
2. 通过一个包含着路径的字符串去解析
在构建时，可以指定路径的格式：
a)PATH_UNIX
b)PATH_WINDOWS
c)PATH_VMS
d)PATH_NATIVE (根据当前系统格式判断)
e)PATH_GUESS (让Poco库自行判断)
从0构造路径
1. 创建一个空路径，使用默认的构造函数(默认情况下路径格式为"相对目录")或者构造时使用一个bool参数去指定路径格式(true = absolute, false = relative)
2. 如果需要的话，使用下列赋值函数去设置节点和设备名
void setNode(const std::string& node)
void setDevice(const std::string& device)
3. 添加路径名
void pushDirectory(const std::string& name)
4. 设置文件名
void setFileName(const std::string& name)
下面是一个例子：
#include "Poco/Path.h"
using namespace std;
int main(int argc, char** argv)
{
Poco::Path p(true); // path will be absolute
p.setNode("VMS001");
p.setDevice("DSK001");
p.pushDirectory("POCO");
p.pushDirectory("INCLUDE");
p.pushDirectory("POCO");
p.setFileName("POCO.H");
std::string s(p.toString(Poco::Path::PATH_VMS));
// "VMS001::DSK001:[POCO.INCLUDE.POCO]POCO.H"
p.clear(); // start over with a clean state
p.pushDirectory("projects");
p.pushDirectory("poco");
s = p.toString(Poco::Path::PATH_WINDOWS); // "projects\poco\"
cout<从一个字符串中解析路径名
1. Poco支持从一个字符串中解析路径名
Path(const std::string& path)
Path(const std::string& path, Style style)
如果函数调用时，路径格式style不被指定，将使用当前系统路径格式。
2. 可以从另一个路径(指向目录名)和文件名，或者两个路径(第一个为绝对路径，第二个为相对路径)构造
Path(const Path& parent, const std::string& fileName)
Path(const Path& parent, const Path& relative)
路径也可以通过下列函数去构建
Path& assign(const std::string& path)
Path& parse(const std::string& path)
Path& assign(const std::string& path, Style style)
Path& parse(const std::string& path, Style style)
如果路径非法的话，会抛出Poco::PathSyntaxException异常。想要测试一个路径字符串是否合法，可以使用tryParse()函数：
bool tryParse(const std::string& path)
bool tryParse(const std::string& path, Style style)
下面是一个例子：
#include "Poco/Path.h"
using Poco::Path;
int main(int argc, char** argv)
{
//creating a path will work independent of the OS
Path p("C:\\Windows\\system32\\cmd.exe");
Path p("/bin/sh");
p = "projects\\poco";
p = "projects/poco";
p.parse("/usr/include/stdio.h", Path::PATH_UNIX);
bool ok = p.tryParse("/usr/*/stdio.h");
ok = p.tryParse("/usr/include/stdio.h", Path::PATH_UNIX);
ok = p.tryParse("/usr/include/stdio.h", Path::PATH_WINDOWS);
ok = p.tryParse("DSK$PROJ:[POCO]BUILD.COM", Path::PATH_GUESS);
return 0;
}Poco::Path类提供了函数用于转换成为字符串：
std::string toString()
std::string toString(Style style)
当然也可以使用下列函数得到路径不同部分的字符串：
const std::string& getNode()
const std::string& getDevice()
const std::string& directory(int n) (also operator [])
const std::string& getFileName()
可以调用下列函数获取目录的深度:
int depth() const
通过下面的函数可以得到和设置文件的基本名和扩展名:
std::string getBaseName() const
void setBaseName(const std::string& baseName)
std::string getExtension() const
void setExtension(const std::string& extension)
下面是一个例子:
#include "Poco/Path.h"
using Poco::Path;
int main(int argc, char** argv)
{
Path p("c:\\projects\\poco\\build_vs80.cmd", Path::PATH_WINDOWS);
std::string device(p.getDevice()); // "c"
int n = p.depth(); // 2
std::string dir1(p.directory(0)); // "projects"
std::string dir2(p[1]); // "poco"
std::string fileName(p[2]); // "build_vs80.cmd"
fileName = p.getFileName();
std::string baseName(p.getBaseName()); // "build_vs80"
std::string extension(p.getExtension()); // "cmd"
p.setBaseName("build_vs71");
fileName = p.getFileName(); // "build_vs71.cmd"
return 0;
} 路径操作:
1. Path& makeDirectory()
确保路径的结尾是一个目录名。如果原路径有文件名存在的话，添加一个与文件名同名的目录，并清除文件名。
2. Path& makeFile()
确保路径的结尾是一个文件名。如果原路径是一个目录名，则把最后一个目录名变成文件名，并去除最后一个目录名。
3. Path& makeParent()
Path parent() const
使路径指向它的父目录(如果存在文件名的话，清除文件名；否则的话则移除最后一个目录名)
4. Path& makeAbsolute()
Path& makeAbsolute(const Path& base)
Path absolute() const
Path absolute(const Path& base)
转换相对路径为绝对路径
5. Path& append(const Path& path)
添加路径
6. Path& resolve(const Path& path)
如果新的路径为绝对路径，则代替现有的路径；否则则在原路径下追加
路径属性：
1. bool isAbsolute() const
如果路径为绝对路径，返回true；否则为false
2. bool isRelative() const
如果路径为相对路径，返回true；否则为false
3. bool isDirectory() const
如果路径为目录，返回true；否则为false
4. bool isFile() const
如果路径为文件，返回true；否则为false
下面是一个例子：
#include "Poco/Path.h"
using Poco::Path;
int main(int argc, char** argv)
{
Path p("/usr/include/stdio.h", Path::PATH_UNIX);
Path parent(p.parent());
std::string s(parent.toString(Path::PATH_UNIX)); // "/usr/include/"
Path p1("stdlib.h");
Path p2("/opt/Poco/include/Poco.h", Path::PATH_UNIX);
p.resolve(p1);
s = p.toString(Path::PATH_UNIX); // "/usr/include/stdlib.h"
p.resolve(p2);
s = p.toString(Path::PATH_UNIX); // "/opt/Poco/include/Poco.h"
return 0;
} 特殊的目录和文件
Poco::Path提供了静态函数，用于获取系统中的一些特殊目录和文件
1. std::string current()
返回当前的工作目录
2. std::string home()
返回用户的主目录
3. std::string temp()
返回操作系统的零时目录
4. std::string null()
返回系统的空目录(e.g., "/dev/null" or "NUL:")
下面是一个例子：
#include "Poco/Path.h"
#include
using Poco::Path;
int main(int argc, char** argv)
{
std::cout
<< "cwd: " << Path::current() << std::endl
<< "home: " << Path::home() << std::endl
<< "temp: " << Path::temp() << std::endl
<< "null: " << Path::null() << std::endl;
return 0;
} 路径和环境变量
在配置文件中的路径经常包含了环境变量。在传递此类路径给Poco::Path之间必须对路径进行扩展。
对包含环境变量的路径扩展可以使用如下函数
std::string expand(const std::string& path)
函数会返回一个对环境变量进行扩充后的路径名。环境变量的格式会根据操作系统有所不同。(e.g., $VAR on Unix, %VAR% on Windows).在Unix上，同样会扩展"~/"为当前用户的主目录。
下面是一个例子：
#include "Poco/Path.h"
using Poco::Path;
int main(int argc, char** argv)
{
std::string config("%HOMEDRIVE%%HOMEPATH%\\config.ini");
// std::string config("$HOME/config.ini");
std::string expConfig(Path::expand(config));
return 0;
}文件系统主目录:
void listRoots(std::vector
会用所有挂载到文件系统的根目录来填充字符串数组。在windows上，为所有的驱动盘符。在OpenVMS上，是所有挂载的磁盘。在Unix上，为"/"。
查询文件:
bool find(const std::string& pathList, const std::string& name, Path& path)
在指定的目录集(pathList)中搜索指定名称的文件(name)。pathList参数中如果指定了多个查找目录，目录之间必须使用分割符 (Windows平台上为";" , Unix平台上为":")。参数name中可以包含相对路径。如果文件在pathList指定的目录集中存在，找到文件的绝对路径会被放入path参数中，并且函数返回true，否则函数返回false，并且path不改变。
这个函数也存在一个使用字符串向量，而不是路径列表的迭代器的变体。定义如下：
bool find(StringVec::const_iterator it, StringVec::const_iterator end, const std::string& name, Path& path)
下面是一个例子：
#include "Poco/Path.h"
#include "Poco/Environment.h"
using Poco::Path;
using Poco::Environment;
int main(int argc, char** argv)
{
std::string shellName("cmd.exe"); // Windows
// std::string shellName("sh"); // Unix
std::string path(Environment::get("PATH"));
Path shellPath;
bool found = Path::find(path, shellName, shellPath);
std::string s(shellPath.toString());
return 0;
}