Path

haxe.io.Path (Class)

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

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

Static Members

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.

Name Type
path String
Returns
String
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.

Name Type
paths Array<String>
Returns
String
normalize(path: String): String

Normalize a given path (e.g. turn '/usr/local/../lib' into '/usr/lib').

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

If path is null, the result is unspecified.

Name Type
path String
Returns
String
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.

Name Type
path String
Returns
String
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.

Name Type
path String
Returns
String

Instance Members

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.

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 "".

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.

backslash: Bool

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

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.

Name Type
path String