C++Introduction to C++Language FeatureLearn C++

How to use SameFileName method on Windows

C++ Builder has a lot of specific methods in its SysUtils library that are included in VCL and FMX libraries. Some of these are grouped as Path Manipulation Routines that allow a user to edit, extract, get and set drive name, directory name, file name, and file extensions. These methods are combined in the Vcl.FileCtrl, System.IOUtils, System.SysUtils libraries. These methods are easy to use and easy to get or set file path strings in that operating system. The functions can be used with other component properties like FileName property of OpenDialog, SaveDialog components. We can also check drives, files, or directories to see if they exist or not on a given path.

In this post, you’ll learn how to determine whether two files are the same, what the SameFileName method in C++ is, and how to compare file names based on the current Windows locale. By learning how to check two file name strings if they are the same on the current locale. It will help you to easily build C++ applications using the C++ IDE.

What is the C++ SameFileName method?

The SameFileName Method (System::SysUtils::SameFileName) is a SysUtils Method that compares file names based on the current locale. SameFileName compares two file names in the same way as AnsiCompareFileName. SameFileName returns True if the file names match, False otherwise. Like AnsiCompareFileName, SameFileName supports locales and MBCS strings; see the AnsiCompareFileName topic for more details.

The following table lists the parameters expected by this method:

NameMeaning
PathThe verified file or directory name

Note: that SameFileName method raises an exception if the given path contains invalid characters.

What is the syntax of the SameFileName method ?

Here is the syntax for the SameFileName Method,

Here is a simple example of using SameFileName Method

Is there a more complete example of how to use the C++ SameFileName method?

Here is the full C++ Builder VCL example,

Note that can use this method with the OpenDialog (TOpenDialog) or SaveDialog (TSaveDialog) components. For example you can check if OpenDialog1->FileName is exactly same as the file name that you want.

C++ Builder is the easiest and fastest C and C++ IDE for building simple or professional applications on the Windows, MacOS, iOS & Android operating systems. It is also easy for beginners to learn with its wide range of samples, tutorials, help files, and LSP support for code. RAD Studio’s C++ Builder version comes with the award-winning VCL framework for high-performance native Windows apps and the powerful FireMonkey (FMX) framework for cross-platform UIs.

There is a free C++ Builder Community Edition for students, beginners, and startups; it can be downloaded from here. For professional developers, there are Professional, Architect, or Enterprise versions of C++ Builder and there is a trial version you can download from here.

Oh hi there 👋
It’s nice to meet you.

Sign up to receive awesome C++ content in your inbox, every day.

We don’t spam! Read our privacy policy for more info.

About author

Dr. Yilmaz Yoru has 35+ years of coding with more than 30+ programming languages, mostly C++ on Windows, Android, Mac-OS, iOS, Linux, and some other operating systems. He graduated and received his MSc and PhD degrees from the Department of Mechanical Engineering of Eskisehir Osmangazi University. He is the founder and CEO of ESENJA LLC Company. His interests are Programming, Thermodynamics, Fluid Mechanics, Artificial Intelligence, 2D & 3D Designs, and high-end innovations.
Related posts
C++C++11C++14C++17C++20Learn C++

What Is The Priority Queue (std::priority_queue) In Modern C++?

C++C++11C++14C++17C++20

What Is The Stack (std::stack) In Modern C++?

C++C++11C++14C++17C++20Learn C++

What Is The Queue (std::queue) In Modern C++?

C++C++11C++14C++17Learn C++SyntaxTemplates

What Are The Logical Operation Metafunctions In Modern C++?