ExtractShortPathName - C++ Build

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