How To Use Python Raw String

This example uses a string with a value: Hi\nHello. If you try to assign this value to a normal string, then the newline character (\n) creates a new line:

s = 'Hi\nHello'

Print the string:

print(s)

The output is:

Hi
Hello

The output shows that the newline character results in a new line.

To include the newline character in the string, prefix the string variable with r or R to create a raw string:

raw_s = r'Hi\nHello'

Print the string:

print(raw_s)

The output is:

Hi\nHello

The output includes the newline character.

If you try to include double backslash characters, such as for a hostname path, in a normal string, then the first backslash character won’t print because the compiler considers the backslash to be an escape indicator.

For example, create a string that contains a path:

s = '\\examplehost\digitalocean\content\'

Print the string:

print(s)

The output is:

\examplehost\digitalocean\content\

The output shows that the first backslash character isn’t included in the string.

To include both backslash characters in the string, prefix the string variable with r or R to create a raw string:

s = r'\\examplehost\digitalocean\content\'

Print the string:

print(s)

The output is:

\\examplehost\digitalocean\content\

The output includes both backslash characters.

In a raw string, quotes can still be escaped with a single backslash character, however, the backslash character remains in the resulting raw string.

In addition, a raw string can’t end with an odd number of backslash characters. Because of this feature, you can’t create a raw string that contains a single backslash character, so r"/" is an invalid string.

Invalid Raw String Examples

In this example, the end quote is missing from the output since it’s being escaped by the backslash character resulting in an unterminated string literal error:

r'\'

In this example, the first two backslashes will escape each other, and the third one will try to escape the end quote, resulting in an unterminated string literal error:

r'ab\\\'

Valid Raw String Examples

Here are some examples of valid raw strings that include quotes and backslash characters.

Create a raw string that escapes quotes:

s = r"\"\""

Print the string:

print(s)

The output is:

\"\"

The output shows that the backslash characters escape the quotes so that the string doesn’t terminate, but the backslash characters remain in the result string.

Create a raw string with an even number of backslash characters:

s = R'ab\\'

Print the string:

print(s)

The output is:

ab\\

The output shows that the even number of backslash characters are included in the result string.

In this article, you learned the basics of raw strings in Python. Continue your learning about Python strings.