class haxe.io.Path

Available on all platforms

This class provides a convenient way of working with paths. It supports the common path formats:

  • directory1/directory2/filename.extension
  • directory1\directory2\filename.excention

Class Fields

static function addTrailingSlash(path:String):String

Adds a trailing slash to path, if it does not have one already.

If the last slash in path is a backslash, a backslash is appended to path.

If the last slash in path is a slash, or if no slash is found, a slash is appended to path. In particular, this applies to the empty String "".

If path is null, the result is unspecified.

static function directory(path:String):String

Returns the directory of path.

If the directory is null, the empty String "" is returned.

If path is null, the result is unspecified.

static function extension(path:String):String

Returns the extension of path.

If the extension is null, the empty String "" is returned.

If path is null, the result is unspecified.

static function join(paths:Array<String>):String

Joins all paths in paths together.

If paths is empty, the empty String "" is returned. Otherwise the paths are joined with a slash between them.

If paths is null, the result is unspecified.

static function normalize(path:String):String

Normalize a given path (e.g. make '/usr/local/../lib' to '/usr/lib').

Also replaces backslashes \ with slashes / and afterwards turns multiple slashes into a single one.

If path is null, the result is unspecified.

static function removeTrailingSlashes(path:String):String

Removes trailing slashes from path.

If path does not end with a / or \, path is returned unchanged.

Otherwise the substring of path excluding the trailing slashes or backslashes is returned.

If path is null, the result is unspecified.

static function withExtension(path:String, ext:String):String

Returns a String representation of path where the extension is ext.

If path has no extension, ext is added as extension.

If path or ext are null, the result is unspecified.

static function withoutDirectory(path:String):String

Returns the String representation of path without the directory.

If path is null, the result is unspecified.

static function withoutExtension(path:String):String

Returns the String representation of path without the file extension.

If path is null, the result is unspecified.

Instance Fields

var backslash:Bool

True if the last directory separator is a backslash, false otherwise.

var dir:String

The directory.

This is the leading part of the path that is not part of the file name and the extension.

Does not end with a / or \ separator.

If the path has no directory, the value is null.

var ext:String

The file extension.

It is separated from the file name by a dot. This dot is not part of the extension.

If the path has no extension, the value is null.

var file:String

The file name.

This is the part of the part between the directory and the extension.

If there is no file name, e.g. for ".htaccess" or "/dir/", the value is the empty String "".

function new(path:String):Void

Creates a new Path instance by parsing path.

Path information can be retrieved by accessing the dir, file and ext properties.

function toString():String

Returns a String representation of this path.

If this.backslash is true, backslash is used as directory separator, otherwise slash is used. This only affects the separator between this.dir and this.file.

If this.directory or this.extension is null, their representation is the empty String "".