33

I came across this code snippet in C++17 draft n4713:

#define R "x"
const char* s = R"y"; // ill-formed raw string, not "x" "y"

What is a "raw string"? What does it do?

S.S. Anne
  • 14,415
  • 7
  • 35
  • 68

3 Answers3

46

Raw string literals are string literals that are designed to make it easier to include nested characters like quotation marks and backslashes that normally have meanings as delimiters and escape sequence starts. They’re useful for, say, encoding text like HTML. For example, contrast

"<a href=\"file\">C:\\Program Files\\</a>"

which is a regular string literal, with

R"(<a href="file">C:\Program Files\</a>)"

which is a raw string literal. Here, the use of parentheses in addition to quotes allows C++ to distinguish a nested quotation mark from the quotation marks delimiting the string itself.

templatetypedef
  • 345,949
  • 98
  • 857
  • 1,030
  • 1
    I did not know why you needed the parenthesis. First thing I've seen on it. So obvious now. Note, you can still prefix it like `uR` and `u8R`, and this also all works on C but only on gnu `-std=gnu99` onwards – Lewis Kelsey Mar 02 '21 at 16:47
29

Basically a raw string literal is a string in which the escape characters (like \n \t or \" ) of C++ are not processed. A raw string literal which starts with R"( and ends in )" ,introduced in C++11

prefix(optional) R "delimiter( raw_characters )delimiter"

prefix - One of L, u8, u, U

Thanks to @Remy Lebeau, delimiter is optional and is typically omitted, but there are corner cases where it is actually needed, in particular if the string content contains the character sequence )" in it, eg: R"(...)"...)", so you would need a delimiter to avoid an error, eg: R"x(...)"...)x".

See an example:

#include <iostream>
#include <string> 
using namespace std;

int main()
{
    string normal_str="First line.\nSecond line.\nEnd of message.\n";
    string raw_str=R"(First line.\nSecond line.\nEnd of message.\n)";
    cout<<normal_str<<endl;
    cout<<raw_str<<endl;
    return 0;
}

output:

First line.

Second line.

End of message.

First line.\nSecond line.\nEnd of message.\n

Oblivion
  • 6,731
  • 2
  • 12
  • 32
  • 2
    But here in the code the `R` is defined as `"x"` and after expansion of the `#define` the code is `const char* s = "x""y";` and there isn't any `R"(`. – Chupo_cro Jun 24 '21 at 14:28
0

Raw string literal. Used to avoid escaping of any character. Anything between the delimiters becomes part of the string. prefix, if present, has the same meaning as described above.

C++Reference: string literal

a Raw string is defined like this:

string raw_str=R"(First line.\nSecond line.\nEnd of message.\n)";

and the difference is that a raw string ignores (escapes) all the special characters like \n ant \t and threats them like normal text.

So the above line would be just one line with 3 actual \n in it, instead of 3 separate lines.

You need to remove the define line and add parentheses around your string to be considered as a raw string.

Community
  • 1
  • 1
  • 1
    Are you certain you'd need to remove the define? I would think were that the case, then the example in its current state would not be an ill-defined raw string, but rather a well-defined string literal. – Christian Gibbons Jun 21 '19 at 21:03