C++ Builder 参考手册 ➙ System::Sysutils ➙ ExtractShortPathName
获取路径和文件名的 8.3 格式的短路径和文件名
头文件:#include <System.SysUtils.hpp>
命名空间:System::Sysutils
函数原型:
System::UnicodeString __fastcall ExtractShortPathName(const System::UnicodeString FileName);
参数:
- FileName 路径和文件名;
返回值:
- 8.3 格式的短文件名,如果 FileName 存在,只有 Windows 操作系统有短文件名;
- 直接返回 FileName,如果 FileName 没有短文件名;
- 空字符串,如果 FileName 不存在。
- 8.3 格式的文件名是古老的 DOS 文件名的标准,文件名最长 8 个字符,后缀最长 3 个字符,文件名和后缀之间用点分隔,所以称为 "8.3" 格式;
- 为了兼容古老的只识别 8.3 格式文件的软件,Windows 操作系统给文件做了兼容,长度超过 8.3 格式的文件,同时还有一个 8.3 格式的短文件名可以访问这个文件,这个函数是获取这个兼容 8.3 格式的短文件名;
- 不是所有的文件都有短文件名,在 Windows 10 / 11 操作系统上测试的结果是 C 盘上的文件有短文件名,D 盘上的文件没有,如果把 D 盘的文件复制到 C 盘,会有短文件名,再复制到 D 盘上就又没有了:
• 例如测试程序 Sysutils_ExtractShortPathName.exe (本文后面的例子) 在 D 盘的文件夹
D:\Hsuanlu\Programs\System.Sysutils\Functions\ExtractShortPathName\
里面的时候,获取的短文件名是这个文件名本身,没有短文件名;
• 把 Sysutils_ExtractShortPathName.exe 复制到C:\Program Files
里面,就能获取到短文件名了,FileName 是
C:\Program Files\Hsuanlu\ExtractShortPathName\Sysutils_ExtractShortPathName.exe
得到的短文件名是
C:\PROGRA~1\Hsuanlu\EXTRAC~1\SYSUTI~1.EXE
• 又测试了在 C 盘根目录创建一个Hsuanlu
文件夹,把测试程序复制到里面,FileName 是
C:\Hsuanlu\ExtractShortPathName\Sysutils_ExtractShortPathName.exe
得到的短文件名是
C:\Hsuanlu\EXTRAC~1\SYSUTI~1.EXE
• 而C:\Hsuanlu\Test1
文件不存在,得到的短文件名是空字符串;
• 又测试了C:\Program Files (x86)\Embarcadero\Studio
得到的短文件名是
C:\PROGRA~2\EMBARC~1\Studio
例子:获取应用程序的路径
void __fastcall TForm1::Button1Click(TObject *Sender)
{
UnicodeString s = Application->ExeName;
Memo1->Lines->Add(s);
Memo1->Lines->Add(Sysutils::ExtractShortPathName(s));
s = L"C:\\Hsuanlu\\Test1";
Memo1->Lines->Add(s);
Memo1->Lines->Add(Sysutils::ExtractShortPathName(s));
s = L"C:\\Program Files (x86)\\Embarcadero\\Studio";
Memo1->Lines->Add(s);
Memo1->Lines->Add(Sysutils::ExtractShortPathName(s));
}
运行结果:
相关:
- System::Sysutils::IncludeTrailingPathDelimiter
- System::Sysutils::ExcludeTrailingPathDelimiter
- System::Sysutils::PathDelim
- System::Sysutils::DriveDelim
- System::Sysutils::ChangeFileExt
- System::Sysutils::ChangeFilePath
- System::Sysutils::ExtractFileDir
- System::Sysutils::ExtractFileDrive
- System::Sysutils::ExtractFileExt
- System::Sysutils::ExtractFileName
- System::Sysutils::ExtractFilePath
- System::Sysutils::ExtractRelativePath
- System::Sysutils::ExtractShortPathName
- System::Sysutils
- std::_fullpath, std::_tfullpath, std::_wfullpath
- std::_makepath, std::_tmakepath, std::_wmakepath
- std::_splitpath, std::_tsplitpath, std::_wsplitpath
- <cstdlib>
C++ Builder 参考手册 ➙ System::Sysutils ➙ ExtractShortPathName