271

Suppose I need to refer to the path C:\meshes\as. If I try writing that directly, like "C:\meshes\as", I encounter problems - either some exception, or the path just doesn't work. Is this because \ is acting as an escape character? How should I write the paths?

Karl Knechtel
  • 62,466
  • 11
  • 102
  • 153
Gareth
  • 3,502
  • 4
  • 20
  • 21
  • See also: https://medium.com/swlh/solved-windows-pip-command-not-found-or-pip-is-not-recognized-as-an-internal-or-external-command-dd34f8b2938f – Gabriel Mar 21 '22 at 10:47

5 Answers5

393

you can use always:

'C:/mydir'

this works both in linux and windows. Other posibility is

'C:\\mydir'

if you have problems with some names you can also try raw string literals:

r'C:\mydir'

however best practice is to use the os.path module functions that always select the correct configuration for your OS:

os.path.join(mydir, myfile)

From python 3.4 you can also use the pathlib module. This is equivelent to the above:

pathlib.Path(mydir, myfile)

or

pathlib.Path(mydir) / myfile
gilbertbw
  • 634
  • 2
  • 9
  • 27
joaquin
  • 82,968
  • 29
  • 138
  • 152
  • 2
    @Gareth, I am very lazy and often found myself using '/'. However in the long run the use of os.path is more convenient. It also allows you to use mydir and myfile as variables that you can easily modify. – joaquin Jun 01 '10 at 22:48
  • 25
    The only thing to be careful with on raw strings is that they can't end with \ – Douglas Leeder Jun 29 '10 at 16:15
  • 1
    You can use os.path.join() to remove the need to end paths with \. – Will Ediger Aug 05 '14 at 14:53
  • 1
    I like the r (raw string) syntax. Useful if you're copying a long path where you'd usually have to replace all the backslashes with forward slashes – peterb Aug 21 '16 at 05:07
  • raw string can end with \\ so we can concatenate a file to the path: codecs.open(r"C:\maXbox\EKON24\tweet_data\\" + file, 'r', encoding='utf-8') as f: – Max Kleiner Jun 24 '20 at 13:34
  • import re; re.sub(r'\\', r'/', test) – thistleknot Jul 04 '21 at 12:35
  • "this works both in linux and windows" - well, the *forward slashes* work, but drive letters are nonsense in linux :) – Karl Knechtel Apr 09 '23 at 01:31
  • Yeah but how do you solve a white space in the folder name? – 71GA Jul 14 '23 at 07:40
  • @71GA what kind of problems are you having with white space in a folder name? Might be a problem on a command line, but not in code. – Mark Ransom Aug 04 '23 at 22:16
45

Use the os.path module.

os.path.join( "C:", "meshes", "as" )

Or use raw strings

r"C:\meshes\as"

I would also recommend no spaces in the path or file names. And you could use double backslashes in your strings.

"C:\\meshes\\as.jpg"
Community
  • 1
  • 1
S.Lott
  • 384,516
  • 81
  • 508
  • 779
  • 20
    os.path.join may not behave as you expect when a component is a drive letter, since relative paths are allowed even then. (The result of the first line is 'C:meshes\\as' on Windows.) – dash-tom-bang Jun 01 '10 at 23:04
  • 1
    @dash-tom-bang's comment is really important. Is the right thing to do to put `"C:\"` as the first entry? Does that mess up some of cleanliness of using `join`? – Jack O'Connor Feb 21 '14 at 00:53
  • 2
    @JackO'Connor that's what I do. You certainly do not want to put `"C:\"` in the middle of the file name. Besides, you can use `os.path.normpath` before or after a join, to make sure the path gets printed nicely. – Agostino Apr 07 '15 at 18:03
  • 2
    but it doesn't work either. What works is `os.path.join( "C:\\", "meshes", "as" )` – Jean-François Fabre Mar 02 '19 at 11:32
  • @JackO'Connor you're dealing with Windows and you're worrying about cleanliness? ;-) – Jürgen A. Erhard Aug 08 '21 at 09:36
33

Yes, \ in Python string literals denotes the start of an escape sequence. In your path you have a valid two-character escape sequence \a, which is collapsed into one character that is ASCII Bell:

>>> '\a'
'\x07'
>>> len('\a')
1
>>> 'C:\meshes\as'
'C:\\meshes\x07s'
>>> print('C:\meshes\as')
C:\meshess

Other common escape sequences include \t (tab), \n (line feed), \r (carriage return):

>>> list('C:\test')
['C', ':', '\t', 'e', 's', 't']
>>> list('C:\nest')
['C', ':', '\n', 'e', 's', 't']
>>> list('C:\rest')
['C', ':', '\r', 'e', 's', 't']

As you can see, in all these examples the backslash and the next character in the literal were grouped together to form a single character in the final string. The full list of Python's escape sequences is here.

There are a variety of ways to deal with that:

  1. Python will not process escape sequences in string literals prefixed with r or R:

    >>> r'C:\meshes\as'
    'C:\\meshes\\as'
    >>> print(r'C:\meshes\as')
    C:\meshes\as
    
  2. Python on Windows should handle forward slashes, too.

  3. You could use os.path.join ...

    >>> import os
    >>> os.path.join('C:', os.sep, 'meshes', 'as')
    'C:\\meshes\\as'
    
  4. ... or the newer pathlib module

    >>> from pathlib import Path
    >>> Path('C:', '/', 'meshes', 'as')
    WindowsPath('C:/meshes/as')
    
vaultah
  • 44,105
  • 12
  • 114
  • 143
  • 1
    "Other common escape sequences include" - don't forget `\U` used for 32-bit Unicode code point escapes. Windows users are very commonly tripped up by this, because they want to access files within `C:\Users`. – Karl Knechtel Apr 09 '23 at 01:33
16

Use Path:

from pathlib import Path
data_folder = Path("source_data/text_files/")
file_to_open = data_folder / "raw_data.txt"
print(file_to_open.read_text())

Path takes a path-like string and adjusts everything for the current OS, either Windows or Linux. For example, on Linux it would convert all backslashes to forward slashes, and on Windows it would do the reverse.

Full article: Python 3 Quick Tip: The easy way to deal with file paths on Windows, Mac and Linux


My experience:

  • I spent 6 months using os.path.join(...), then switched to normpath(...) then finally switched to Path(...). Having used all three, Path is the best of all worlds.

Advantages of Path over os.path.join(...):

  • Cleaner.
  • Less typing.
  • Easier to read the paths (i.e. more readable).
  • Can join two different paths using / (see above).
  • More modern.

Advantages of path over normpath(...):

  • Can join paths using / rather than having to fall back to os.path.join(...), with nested normpath calls to fix things up.
  • Cleaner.
  • Less typing.
  • Easier to read the paths (i.e. more readable).
  • Less chance of bugs when porting between Linux and Windows.
  • More modern.
Contango
  • 76,540
  • 58
  • 260
  • 305
7

Python raw string is created by prefixing a string literal with ‘r’ or ‘R’. Python raw string treats backslash () as a literal character. This is useful when we want to have a string that contains backslash and don’t want it to be treated as an escape character.

Doing Manually Such as:

WindowsPath("C:\meshes\as")

or by using r or R:

WindowsPath(r'C:/meshes/as')