CSplitpath:Class Description

CSplitpath Class

The CSplitpath class is used to manipulate file paths. Use this class to replace elements of the path such as the file name, directory, file extension, etc.

A complete path name consists of the following components:

Machine name

Drive Name

Directory Name

File Name

Extension

The combination of machine name, drive name, and directory name is called the "folder".

Usage

Construction	Object = CSplitpath:new()
Destruction	Object:delete()

Data Members

The data members in the table below may be accessed directly. However, it is better programming style to work with them using only class methods.

ptr	A pointer to the Mira splitpath object. The pointer is nil if the statistics object does not exist. Note: It is not wise to work directly with the value of ptr. Instead, refer to ptr using the CSplitpath:Get method.

Methods

Construction & Destruction

new	Creates a new instance of the CSplitpath class.
delete	Deletes the instance of the CSplitpath object and deletes its image from memory.

Accessing Path Components

GetDir	Returns the directory name.
GetDrive	Returns the drive name.
GetExt	Returns the extension with a preceding period, as '.ext'.
GetExt2	Returns the extension as "ext".
GetFilename	Returns the file name without its extension.
GetFilenameExt	Returns the filename + extension.
GetName	Returns the machine name.
GetFolder	Returns the machine name + drive + directory with a trailing '\'.
GetFolder2	Returns the machine name + drive + directory without a trailing '\'.
SetDir	Sets the directory name.
SetDrive	Sets the drive name.
SetExt	Sets the extension.
SetFilename	Sets the filename.
SetFilenameExt	Sets the filename + extension.
SetFolder	Sets the folder: machine name + drive + directory.
SetName	Sets the machine name.
SetPath	Sets the full path but does not split it into components.
SetSubdir	Appends a subdirectory to the path.

Operations

Merge	Merge the components into a new path.
SetPath	Initialize the CSplitpath object with a pathname and split it into components.
Split	Split a specified path into its components.