【发布时间】:2023-03-13 21:20:01
【问题描述】:
所以,我必须事先承认我已经知道答案。我要求其他碰巧遇到相同问题的人可以找到解决因文档不正确引起的问题的方法。
我的环境是VS 2015 C++,wxWidgets 3.0.2,在Windows 7上开发。
在某些遗留代码中,未检查对 wxMkDir 的调用是否成功。根据wxWidgets documentation,wxMkDir的返回类型为bool,成功则返回true。但是,成功时返回 0。
为什么?
【问题讨论】:
所以,我必须事先承认我已经知道答案。我要求其他碰巧遇到相同问题的人可以找到解决因文档不正确引起的问题的方法。
我的环境是VS 2015 C++,wxWidgets 3.0.2,在Windows 7上开发。
在某些遗留代码中,未检查对 wxMkDir 的调用是否成功。根据wxWidgets documentation,wxMkDir的返回类型为bool,成功则返回true。但是,成功时返回 0。
为什么?
【问题讨论】:
答案有两个:有两个名称相似的函数wxMkdir and wxMkDir,前者已记录,后者未记录。第二部分是,看似有效的假设他们将表现相同并不是一个有效的假设。
未记录的函数 wxMkDir 映射到 wxCRT_MkDir,后者又映射到 wxCRT_MkDirA,然后映射到 wxPOSIX_IDENT(mkdir),后者为提到的 POSIX 函数 mkdir 创建一个依赖于平台的名称。根据POSIX documentation for mkdir
成功完成后,mkdir()返回0,否则返回-1,不创建目录,设置errno指示错误。
所以,条件如下:
if (!wxMkDir(newDir)) {
// handle the error here
}
会失败,但是:
if (wxMkDir(newDir) != 0) {
// handle the error here
}
将根据目录是否已创建而按预期工作。
文档中的函数 wxMkdir 在 wx 源文件 filefn.cpp 中实现,并利用 mkdir,但带有像上面这样的条件来映射到适当的 bool 返回值。
【讨论】:
wxMkdir() 和 wxMkDir() 是 wxWidgets 为所有标准提供 wxFoo() 包装器的一般规则的不幸和丑陋的例外(意味着 ANSI C 或 POSIX,因为在实践中,后者大约是标准并且更多所以比 C99) 函数 foo() 存在于窄 (char*) 和宽 (wchar_t*) 版本中。
因此,根据这条一般规则,您会期望 wxMkdir() 的行为与 std::mkdir() 一样,但不幸的是 wxMkdir() 早于 wxWidgets 的 Unicode 化好几年,所以这条规则不能由于向后兼容性,为此实现了它,并且必须发明另一个函数来作为 std::mkdir() 的包装器。
当然,到现在为止,向后兼容的重量甚至更重,这里似乎真的没有任何合理的事情可以做——除了建议人们使用明确的wxFileName::Mkdir()。
</sad-story>
【讨论】: