AnsiCompareFileName - C++ Builde

C++ Builder 参考手册 ➙ System::Sysutils ➙ AnsiCompareFileName

---

比较两个文件名，使用当前的地区和语言，并且根据操作系统文件名是否区分大小写。

头文件：#include <System.SysUtils.hpp>
命名空间：System::Sysutils
函数原型：

int __fastcall AnsiCompareFileName(
    const System::UnicodeString S1, 
    const System::UnicodeString S2, 
    bool CheckVolumeCase = false);

参数：

S1: 要比较的文件名字符串1，UnicodeString 类型；
S2: 要比较的文件名字符串2，UnicodeString 类型；
CheckVolumeCase: 是否检查文件系统是否区分大小写；

返回值：

0: S1==S2
>0: S1>S2
<0: S1<S2

• 比较两个文件名，使用当前的地区和语言；
• 如果 CheckVolumeCase 为 false，在 Windows 操作系统里面不区分大小写，在 Linux / MAC OS 里面区分大小写；
• 如果 CheckVolumeCase 为 true，检查 S1 和 S2 所在的文件系统是否区分大小写，如果 S1 和 S2 所在文件系统当中，存在区分大小写的系统，就按照区分大小写比较；
• 这个函数的参数都是 UnicodeString 类型的了，虽然函数名以 Ansi 开头，参数为 AnsiString 类型的函数都移到 System.AnsiStrings.hpp 这个头文件里面了，参数为 AnsiString 类型的函数都看作过时的函数，不建议使用了。

---

例子：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    int r = Sysutils::AnsiCompareFileName(Edit1->Text, Edit2->Text);
    if(r > 0)
        ShowMessage(Edit1->Text + L" > " + Edit2->Text);
    else if(r < 0)
        ShowMessage(Edit1->Text + L" < " + Edit2->Text);
    else
        ShowMessage(Edit1->Text + L" = " + Edit2->Text);
}

运行结果：

1. Edit1 输入 d:\abc\ΩΠ\你好ā
   Edit2 输入 D:\ABC\ωπ\你好Ā
   点击按钮 Button1，弹出对话框：d:\abc\ΩΠ\你好ā = D:\ABC\ωπ\你好Ā
   说明在 Windows 操作系统里面文件名不区分大小写，这两个文件名是相同的；
2. Edit1 输入 d:\abc\def
   Edit2 输入 D:\ABC\defg
   点击按钮 Button1，弹出对话框：d:\abc\def < D:\ABC\defg
3. Edit1 输入 d:\abc\defh
   Edit2 输入 D:\ABC\defg
   点击按钮 Button1，弹出对话框：d:\abc\defh > D:\ABC\defg
   通过 1., 2. 和 3. 可以看到，大写和小写认为是相同的，字符串长短不同，或者字符不同比较的结果为不同 (大于或小于)。

运行结果 运行结果 运行结果

---

相关：

• System::Sysutils::AnsiCompareStr
• System::Sysutils::AnsiCompareText
• System::Sysutils::AnsiStrComp
• System::Sysutils::AnsiStrIComp
• System::Sysutils::AnsiStrLComp
• System::Sysutils::AnsiStrLIComp
• System::Sysutils::CompareMem
• System::Sysutils::CompareStr
• System::Sysutils::CompareText
• System::Sysutils::StrComp
• System::Sysutils::StrIComp
• System::Sysutils::StrLComp
• System::Sysutils::StrLIComp
• System::Sysutils::WideCompareStr
• System::Sysutils::WideCompareText
• System::Sysutils
• strcmp, _strcmp, _fstrcmp, _tcscmp, wcscmp
• strncmp, _fstrncmp, _tcsncmp, _tcsnccmp, wcsncmp
• stricmp, _stricmp, _fstricmp, strcmpi, _strcmpi, _tcsicmp, _tcscmpi, _wcsicmp, wcscmpi, _wcscmpi
• strnicmp, _strnicmp, _fstrnicmp, strncmpi, _tcsnicmp, _tcsncicmp, _tcsncmpi, _wcsnicmp, wcsncmpi, _wcsncmpi
• <cstring>

---

C++ Builder 参考手册 ➙ System::Sysutils ➙ AnsiCompareFileName