Python Tutorial

The os.path.basename() is a method in Python's os.path module that returns the base name of a file path. The base name is the final component of the path, after stripping all parent directory and extension information.

For example, if the path is /home/user/Documents/myfile.txt, the base name is myfile.txt.

Syntax for os.path.basename():

The path argument is a string representing the file path whose base name we want to retrieve. The method returns a string that contains the file path's base name. The method also returns an empty string if the path parameter is an empty string.

Example 1:

import os
path = '/home/user/Documents/myfile.txt'
basename = os.path.basename(path)
print(basename)   

Output:

'myfile.txt'

Example 2:

Let's take another example with an empty string:

import os
path = ''
basename = os.path.basename(path)
print(basename)  

Output:

""

os.path.basename() does not check if the file or directory exists, it only extracts the base name from the provided path.

Some additional points are as follows:

The method works on all operating systems:

path.basename() is part of Python's os.path module, which provides a platform-independent way to work with file paths. It means that the method works on all operating systems (Windows, Linux, macOS, etc.) and automatically adapts to the file path conventions of the current platform.

The method can handle different file path formats:

path.basename() can handle file paths in different formats, including both absolute and relative paths. It can also handle paths with forward slashes (/) or backslashes (\), which are the path separators used on different platforms.

The method can handle paths with or without extensions:

path.basename() can handle file paths with or without extensions. The method returns the base name without the extension if the file path contains an extension. If the file path does not have an extension, the method returns the entire base name.

The method can handle directories:

path.basename() can also handle directory paths, returning the name of the directory as the base name. For example, if the path is /home/user/Documents/, then the base name is Documents.

Here are some more examples:

import os
path1 = '/home/user/Documents/myfile.txt'
basename1 = os.path.basename(path1)
print(basename1)   # Output: 'myfile.txt'

path2 = 'C:\\Users\\user\\Documents\\myfile.txt'
basename2 = os.path.basename(path2)
print(basename2)   # Output: 'myfile.txt'
path3 = '/home/user/Documents/'
basename3 = os.path.basename(path3)
print(basename3)   # Output: 'Documents'
path4 = 'myfile'
basename4 = os.path.basename(path4)
print(basename4)   # Output: 'myfile'

os.path.basename() returns a string object:

The method provides a string object that denotes the file path's base name. It means that you can use string methods on the returned value, such as strip(), split(), replace(), etc.

The method does not modify the original file path:

path.basename() does not modify the original file path in any way. It simply returns the base name of the file path. If you want to modify the file path, you can do so separately using other methods from the os.path module.

os.path.basename() can be used with another os.path methods:

path.basename() can be used in combination with other methods from the os.path module to manipulate file paths. For example, you can use os.path.join() to join two or more path components, and then use os.path.basename() to extract the base name of the resulting path.

Here is an example:

import os
path1 = '/home/user'
path2 = 'Documents/myfile.txt'
# Join two path components
joined_path = os.path.join(path1, path2)
# Get the base name of the joined path
basename = os.path.basename(joined_path)
print(joined_path)   # Output: '/home/user/Documents/myfile.txt'
print(basename)      # Output: 'myfile.txt'

Next TopicPandas: Get and Set Options for Display, Data Behaviour

← prev next →