Path (computing)

Last updated

A path (or filepath, file path, pathname, or similar) is a string that uniquely identifies an item in a hierarchical file system. Generally, a path is composed of directory names, special format specifiers, and optionally a filename, all separated by delimiters. This delimiter can vary by operating system, but popular, modern systems use the slash /, backslash \, or colon :.

Contents

A path can be either relative or absolute. A relative path is a path in relation to another, most often the working directory. An absolute path indicates a location regardless of the current directory, and therefore does not depend on context like a relative path does.

Paths are also essential in the construction of URLs.

History

Multics first introduced a hierarchical file system with directories (separated by ">") in the mid-1960s. [1]

Around 1970, Unix introduced the slash / as its directory separator.

Originally, MS-DOS did not support directories. When adding the feature, using the Unix standard of a slash was not a good option since many existing commands used a slash as the switch prefix (i.e., dir /w). In contrast, Unix uses the dash - as the switch prefix. The backslash \ was ultimately chosen instead for its similarity to the slash and not conflicting with existing commands. This convention continued into Windows. However, some areas of Windows do accept or understand Unix-style slashes also, such as PowerShell. [2] [3]

Summary of systems

The following table describes the syntax of paths in notable operating systems:

SystemRoot dir.Path delim.Working dir.Parent dir.Home dir.Examples
Unix and Unix-like systems, including macOS [4] //...~/home/user/docs/Letter.txt
./child
../../greatgrandparent
~/.rcinfo
Windows, Command Prompt \ (relative to current working directory root)
or [drive letter]:\
or \\.\
or \\?\
or UNC
/ [a]
or \
...C:\user\docs\Letter.txt
/user/docs/Letter.txtC:\user\docs\somefile.ext:alternate stream name

C:picture.jpg
\\?\UNC\Server01\user\docs\Letter.txt
\\.\COM1

PowerShell [drive letter]:/
or [drive name]:\
or [PSSnapIn name]\[PSProvider name]::[PSDrive root]
or UNC
/ [a]
or \
...~C:\user\docs\Letter.txt
~\DesktopUserDocs:/Letter.txt
Variable:PSVersionTable
Registry::HKEY_LOCAL_MACHINE\SOFTWARE\
Microsoft.PowerShell.Security\Certificate::CurrentUser\
UNC [5] \\[server]\[sharename]\/\\Server01\user\docs\Letter.txt
DOS, COMMAND.COM [drive letter]:\
or \\[server name]\[volume]\
\...C:\USER\DOCS\LETTER.TXT
A:PICTURE.JPG
\\SERVER01\USER\DOCS\LETTER.TXT
OS/2 [drive letter]:\
or \\[server name]\[volume]\
/
or \
...C:\user\docs\Letter.txt
A:Picture.jpg
\\SERVER01\USER\docs\Letter.txt
RSX-11 MCR [6] [device name]:DR0:[30,12]LETTER.TXT;4 [b]
TOPS-20 DCL [7] [device name]:.PS:<USER.DOCS>LETTER.TXT,4
OpenVMS DCL [8] [9] [device name]:[000000]
or [NODE["accountname password"]]::[device name][000000]:
.[][-]SYS$LOGIN:NODE$DISK:[USER.DOCS]PHOTO.JPGUSER:[000000]000000.DIR[]IN_THIS_DIR.COM;
[-.-]GreatGrandParent.TXT
SYS$SYSDEVICE:[.DRAFTS]LETTER.TXT;4
GEIN::[000000]LETTER.TXT;4
SYS$LOGIN:LOGIN.COM
ProDOS AppleSoft BASIC [10] /[volume or drive name]///SCHOOL.DISK/APPLEWORKS/MY.REPORTFLIGHT.SIMULATOR,D2
AmigaOS Amiga CLI / AmigaShell [11] [drive, volume, device, or assign name]:/empty string/Workbench:Utilities/MultiView
DF0:S/Startup-Sequence
S:Startup-Sequence
TCP:en.wikipedia.com/80
RISC OS ShellCLI [12] [fs type[#option]:][:drive number or disc name.]$ [c] .@^&ADFS::MyDrive.$.Documents.Letter
Net#MainServer::DataDrive.$.Main.sy10823
LanMan::WindowsC.$.Pictures.Japan/gif
NFS:&.!Choices
ADFS:%.IfThere
@.inthisdir
^.^.greatgrandparent [d]
Symbian OS File manager\\\user\docs\Letter.txt
Domain/OS Shell [13] // (root of domain)
or / (root of current node)
/.\~//node/home/user/docs/Letter.txt
./inthisdir
\\greatgrandparent
~rcinfo
MenuetOS CMD///file
Stratus VOS CLI%[system_name]#[module_name]>><%sysname#module1>SubDir>AnotherDir
NonStop
Kernel
TACL [e]
.\NODE.$DISK.SUBVOL.FILE
\NODE.$DEVICE
\NODE.$DEVICE.#SUBDEV.QUALIFIER
CP/M CCP [14] [drive letter:]no subdirectories, only user areas 0–FA:LETTER.TXT
GS/OS :[volume name]:
or.[device name]:
or [prefix]: [f]
:
or /
@:Apps:Platinum.Paint:Platinum.Paint
*:System:Finder
.APPLEDISK3.5B/file
OpenHarmony exec [15] [16] hb set -root [ROOT_PATH]
or hb set -p --product [PRODUCT_NAME]
>./../LOCAL>MEDIA_TYPE_>Download>Letter.txt

In programming languages

Most programming languages use the path representation of the underlying system, but some may also be system-independent.

For instance, this C code is system-dependent and may fail on opposing systems:

uxFile=fopen("project/readme.txt","r")// Fails on WindowswinFile=fopen("C:\\Program Files\\bin\\config.bat","r")// Fails on Unix
importjava.io.File;importjava.nio.file.Path;importjava.nio.file.Paths;// ...Filefile=newFile("path"+File.separator+"file.txt");Pathpath=Paths.get("path","file.txt");
frompathlibimportPathwith(Path("path")/"to"/"file.txt").open()asopen_file:...

In Unix

Most Unix-like systems use a similar syntax. [20] POSIX allows treating a path beginning with two slashes in an implementation-defined manner, [21] though in other cases systems must treat consecutive slashes as one. [22]

Many applications on Unix-like systems (for example, scp, rcp, and rsync) use resource definitions such as hostname:/directorypath/resource, or URI schemes with the service name (here 'smb'), like smb://hostname/directorypath/resource.

In macOS

When macOS was being developed, it inherited some pathname choices from Classic Mac OS and the Unix-like NeXTSTEP. The classic Mac OS uses a : while Unix and Unix-like systems use a / as the path delimiter. As a solution, to preserve compatibility for software and familiarity for users, and to allow disk file systems to be used both by the classic Mac OS and macOS, some portions of macOS convert between colons and slashes in pathnames; [23] for example, the HFS+ file system, from the classic Mac OS, converts colons in file names to slashes and, when reading a directory, converts slashes in filenames to colons, [24] as and the Carbon toolkit converts colons in pathnames to slashes and slashes in path names to colons, and converts them back when providing filenames and pathnames to the caller. [24]

In DOS and Windows

Screenshot of a Windows Command Prompt shell showing filenames in a directory Dir command in Windows Command Prompt.png
Screenshot of a Windows Command Prompt shell showing filenames in a directory

DOS and Windows have no single root directory; a root exists for each storage drive, indicated with a drive letter or through UNC.

Directory and file name comparisons are case-insensitive: "test.TXT" would match "Test.txt". [25]

Windows understands the following kinds of paths:

In the Windows API, file I/O functions automatically convert / into \ (except when using the \\?\ prefix). Unless the \\?\ prefix is used, paths are limited to the length defined by MAX_PATH, which is 260. [27]

PowerShell allows slash-interoperability for backwards-compatibility: [28]

PS C:\>Get-Content-Path"C:/path/to/file.txt"Hereissometextwithinafile

Yen/won character error

Japanese and Korean versions of Windows often displayed the '¥' character or the '' character instead of the directory separator. This is because while in ANSI codepages, the character at 0x5C was the backslash, and in Japanese and Korean codepages, 0x5C was the yen and won signs, respectively. Therefore, when the character for a backslash was used, other glyphs appeared. [29]

Universal Naming Convention

The Microsoft Universal Naming Convention (UNC, uniform naming convention, or network path), is a syntax to describe the location of a network resource, such as a shared file, directory, or printer. A UNC path has the general form:

\\ComputerName\SharedFolder\Resource

Some Windows interfaces allow or require UNC syntax for WebDAV share access, rather than a URL. The UNC syntax is extended with optional components to denote use of SSL and TCP/IP port number. Thus, the WebDAV URL of https://hostname[:port]/SharedFolder/Resource becomes \\hostname[@SSL][@port]\SharedFolder\Resource. [30]

When viewed remotely, the "SharedFolder" may have a name different from what a program on the server sees when opening "\SharedFolder". Instead, the SharedFolder name consists of an arbitrary name assigned to the folder when defining its "sharing".

Since UNCs start with two backslashes, and the backslash is also used for escape sequences and in regular expressions, cases of leaning toothpick syndrome may arise. An escaped string for a regular expression matching a UNC begins with 8 backslashes \\\\\\\\ because the string and regular expression both require escaping. This can be simplified by using raw strings, such as @"\\\\" in C#, r'\\\\' in Python, or qr{\\\\} in Perl.

See also

Notes

  1. 1 2 Limited compatibility, may not work in all Windows programs
  2. In order, the fields are ddnn:[g,m]:filename.type;version
  3. &, %, and @ can also be used to reference the root of the current user, the library, and the current directory respectively
  4. When filesystems with filename extensions are mounted, . characters are changed to /, as in the Japan/gif example above
  5. Short for Tandem Advanced Command Language
  6. [prefix] may be a number (0–31),  * (boot volume) or @ (AppleShare home directory)

References

  1. Daley, R.C.; Neumann, P.G. (1965). "A general-purpose file system for secondary storage". Proceedings of the November 30--December 1, 1965, fall joint computer conference, Part I on XX - AFIPS '65 (Fall, part I). Vol. Part I. pp. 213–229. doi: 10.1145/1463891.1463915 . S2CID   16236414.
  2. "Why Windows Uses Backslashes and Everything else Uses Forward Slashes". 10 February 2014.
  3. "Why is the DOS path character "\"?". 24 June 2005.
  4. "File System Basics". developer.apple.com. 9 April 2018. Retrieved 7 September 2025.
  5. "UNC Network Share Access (Windows)". www.ibm.com. Retrieved 7 September 2025.
  6. RSX-11M-PLUS MCR Operations Manual (4th ed.). Digital Equipment Corporation. August 1987. pp. 26–31.
  7. Herkert, Mark Klause Herman; Smith, Sheri Lynn (December 1985). Defense Data Network/TOPS-20 Tutorial. An Interative Computer Program (PDF) (Technical report).
  8. Rabe, Bernhard (6 June 2011). "OpenVMS & DCL on Alpha & VAX" (PDF).
  9. "VSI OpenVMS User's Manual" (PDF). VMS Software. 2025. Retrieved 7 September 2025.
  10. ProDOS User's Manual. Apple Computer. 1983. pp. 56–62.
  11. The AmigaDOS Manual. Produced by Commodore-Amiga, Inc. Bantam Computer Books. February 1986. pp. 6–16. ISBN   978-0-553-34294-9.{{cite book}}: CS1 maint: others (link)
  12. "RISC OS PRMs: Volume 2: Chapter 44: Writing a filing system". www.riscos.com Technical Support: Programmer's Reference Manual. 3QD Developments Ltd. 3 November 2015. Retrieved 7 September 2025.
  13. Getting Started with Domain/OS. Apollo Computer. May 1988. pp. 7.1 –7.7.
  14. CP/M Operating System Manual (3rd ed.). Digital Research. September 1983.
  15. "Introduction to the Shell". GitHub. OpenAtom OpenHarmony. Retrieved 13 March 2024.
  16. "exec". GitHub. OpenAtom OpenHarmony. Retrieved 14 March 2024.
  17. "Java Development Kit Version 17 API Specification". docs.oracle.com. Retrieved 7 September 2025.
  18. "os.path — Common pathname manipulations". Python documentation. Retrieved 7 September 2025.
  19. "Seed7 Manual: Operating system access". seed7.net. Retrieved 7 September 2025.
  20. "UNC Definition". ComputerLanguage.com.
  21. "POSIX pathname resolution specification".
  22. "POSIX pathname definition".
  23. Chan, Alex (1 December 2021). "A tale of two path separators". alexwlchan.net. Retrieved 7 September 2025.
  24. 1 2 Sanches, Wilfredo (2000). "The Challenges of Integrating the Unix and Mac OS Environments".
  25. 1 2 De George, Andy (14 December 2022). "File path formats on Windows systems". Microsoft Docs . Retrieved 14 July 2019.
  26. Ashcraft, Alvin (28 August 2024). "Naming Files, Paths, and Namespaces". Microsoft Docs .
  27. Ashcraft, Alvin (16 July 2024). "Maximum Path Length Limitation - Win32 apps". learn.microsoft.com. Retrieved 7 September 2025.
  28. Wheeler, Sean. "about_Path_Syntax - PowerShell". learn.microsoft.com. Retrieved 7 September 2025.
  29. "When is a backslash not a backslash?". Sorting it all Out.
  30. "DavGetHTTPFromUNCPath function". WebDAV: Windows. Microsoft Docs . series. 13 October 2021. Retrieved 4 October 2023.