escaping - Why do I have to use double backslashes for file-paths in code?

Question

In my program I'm trying to open a file, for example C:unescapedackslashes.txt, but it fails to open! Why?

What is this?

This is a collection of common Q&A. This is also a Community Wiki, so everyone is invited to participate in maintaining it.

Why is this?

There are a lot of questions in the site which boil down to OP not knowing he/she needs to escape backslashes in file paths in the source code. The questions are usually "Why is my program not working?" or "Why is the file not found?", and somewhere in the source code there will be:

const char *fileName = "C:unescapedackslashes.txt";

What's the scope?

This question is applicable for C, C++, Java, Python, and others languages where the compiler treats backslash as the escape character.

Meta post for reference - Proposal for exact-duplicate sink for all the "double-backslashes in filename" questions

Answer 1

This is the preliminary answer. It's community-wiki so feel free to improve it.

Somewhere in your code you have a file-path that contains unescaped backslashes. For example:

const char *fileName = "c:unescapedackslashes.txt";

You need to change it into:

const char *fileName = "c:\unescaped\backslashes.txt";

Why?

The compiler in C, C++, Java, Python and other languages treats the backslash as a special character, called the escape character.

For example will be turned into a newline. So this code - printf("C: ew file.txt"); will print

C:
ew file.txt

So if you have a file name that contains backslashes, what the program will receive will not be what you see in the source code. The backslash itself can be escaped with another backslash. So this code - printf("C:\new file.txt"); will print this:

C:
ew file.txt