371

I have a pretty long sqlite query:

const char *sql_query = "SELECT statuses.word_id FROM lang1_words, statuses WHERE statuses.word_id = lang1_words.word_id ORDER BY lang1_words.word ASC";

How can I break it in a number of lines to make it easier to read? If I do the following:

const char *sql_query = "SELECT word_id
                        FROM table1, table2
                        WHERE table2.word_id = table1.word_id
                        ORDER BY table1.word ASC";

I am getting an error.

Is there a way to write queries in multiple lines?

9 Answers 9

647

There are two ways to split strings over multiple lines:

  1. Each string on its own line. Works only with strings:

    • Plain C:

      char *my_string = "Line 1 "
                        "Line 2";
      
    • Objective-C:

      NSString *my_string = @"Line1 "
                             "Line2";    // the second @ is optional
      
  2. Using \ - can be used for any expression:

    • Plain C:

      char *my_string = "Line 1 \
                         Line 2";
      
    • Objective-C:

      NSString *my_string = @"Line1 \
                              Line2";
      

The first approach is better, because there isn't a lot of whitespace included. For a SQL query however, both are possible.

NOTE: With a #define, you have to add an extra \ to concatenate the two strings:

Plain C:

#define kMyString "Line 1"\
                  "Line 2"
9
  • 27
    Both of these are the same as in and C and C++. The latter solution is preferred because former one embeds a lot of useless white space into the program which will also be transmitted to the DB server.
    – Alnitak
    Apr 28, 2009 at 11:34
  • You're missing an @ at the start of line 2 in the better Objective-C example.
    – Redwood
    Jun 15, 2010 at 23:27
  • Do you have a link to a spec documenting the optionality of the second @? Jun 5, 2012 at 18:10
  • 12
    Another advantage of the better approach is, that you can put // comments after each line.
    – fishinear
    Dec 2, 2013 at 13:37
  • 2
    Does the second approach insert either \n or \r\n between the lines?
    – Charles W
    Aug 14, 2017 at 23:09
133

There's a trick you can do with the pre-processor.
It has the potential down sides that it will collapse white-space, and could be confusing for people reading the code.
But, it has the up side that you don't need to escape quote characters inside it.

#define QUOTE(...) #__VA_ARGS__
const char *sql_query = QUOTE(
    SELECT word_id
    FROM table1, table2
    WHERE table2.word_id = table1.word_id
    ORDER BY table1.word ASC
);

the preprocessor turns this into:

const char *sql_query = "SELECT word_id FROM table1, table2 WHERE table2.word_id = table1.word_id ORDER BY table1.word ASC";

I've used this trick when I was writing some unit tests that had large literal strings containing JSON. It meant that I didn't have to escape every quote character \".

5
  • 8
    Perfect! Now I just need to give this a few more hundred upvotes, and get it where it belongs...
    – Mike
    Oct 22, 2014 at 12:29
  • I was reacting the same way, but this is not without issues. I just tried doing a heredoc this way with a special Unicode character and got an error about non-ASCII characters not being allowed outside of literals.
    – philipkd
    Jan 4, 2017 at 13:42
  • +1 but for the record I´m having trouble with the compiler (MSVC) or editor (QtCreator) not (re)compiling the expression as it should on change. It is like change is not detected... Hitting Rebuild instead of Build does the trick.
    – Andreas
    Oct 11, 2017 at 18:57
  • Thank you for this Chicken Nugget of information. It does exactly what I needed to do without all the extra garbage.
    – FishGuy876
    Aug 23, 2019 at 13:55
  • This unfortunately doesn't work if you have literal quotation marks in the string. Well, it kind of works, in that it generates a warning. But my codebase is -Werror... May 30, 2020 at 3:11
25

You could also go into XCode -> Preferences, select the Indentation tab, and turn on Line Wrapping.

That way, you won't have to type anything extra, and it will work for the stuff you already wrote. :-)

One annoying thing though is...

if (you're long on indentation
    && short on windows) {
            then your code will
                end up squished
                     against th
                         e side
                             li
                              k
                              e

                              t
                              h
                              i
                              s
}
1
  • 2
    @YoYoYonnY I agree, but I also appreciate it. It strikes me that this comment would not have been truly possible as a comment, hence the use of the answer format. This seems like a limitation of S/O, that you can't write particularly rich comments (as far as I am aware). Sep 27, 2016 at 11:01
24

I am having this problem all the time, so I made a tiny tool to convert text to an escaped multi-line Objective-C string:

http://multilineobjc.herokuapp.com/

Hope this saves you some time.

6
20

Extending the Quote idea for Objective-C:

#define NSStringMultiline(...) [[NSString alloc] initWithCString:#__VA_ARGS__ encoding:NSUTF8StringEncoding]

NSString *sql = NSStringMultiline(
    SELECT name, age
    FROM users
    WHERE loggedin = true
);
5
  • 4
    #define NSStringMultiline(...) @#__VA_ARGS__ should work too. Jan 31, 2015 at 3:41
  • For mutable strings: #define NSStringMultiline(...) [[NSMutableString alloc] initWithCString:#__VA_ARGS__ encoding:NSUTF8StringEncoding]
    – rimsky
    Mar 21, 2015 at 0:40
  • For me, the resulting string does not have new lines.
    – rimsky
    Mar 21, 2015 at 0:45
  • Escaped newlines are captured correctly (which is not nearly so convenient or nice).
    – rimsky
    Mar 21, 2015 at 0:52
  • @rimsky, And I think that #define NSStringMultiline(...) [@#__VA_ARGS__ mutableCopy] also works for mutable strings. Feb 17, 2016 at 8:57
8

One more solution for the pile, change your .m file to .mm so that it becomes Objective-C++ and use C++ raw literals, like this:

const char *sql_query = R"(SELECT word_id
                           FROM table1, table2
                           WHERE table2.word_id = table1.word_id
                           ORDER BY table1.word ASC)";

Raw literals ignore everything until the termination sequence, which in the default case is parenthesis-quote.

If the parenthesis-quote sequence has to appear in the string somewhere, you can easily specify a custom delimiter too, like this:

const char *sql_query = R"T3RM!N8(
                                  SELECT word_id
                                  FROM table1, table2
                                  WHERE table2.word_id = table1.word_id
                                  ORDER BY table1.word ASC
                         )T3RM!N8";
1
5

GCC adds C++ multiline raw string literals as a C extension

C++11 has raw string literals as mentioned at: https://stackoverflow.com/a/44337236/895245

However, GCC also adds them as a C extension, you just have to use -std=gnu99 instead of -std=c99. E.g.:

main.c

#include <assert.h>
#include <string.h>

int main(void) {
    assert(strcmp(R"(
a
b
)", "\na\nb\n") == 0);
}

Compile and run:

gcc -o main -pedantic -std=gnu99 -Wall -Wextra main.c
./main

This can be used for example to insert multiline inline assembly into C code: How to write multiline inline assembly code in GCC C++?

Now you just have to lay back, and wait for it to be standardized on C20XY.

C++ was asked at: C++ multiline string literal

Tested on Ubuntu 16.04, GCC 6.4.0, binutils 2.26.1.

4

You can also do:

NSString * query = @"SELECT * FROM foo "
                   @"WHERE "
                     @"bar = 42 "
                     @"AND baz = datetime() "
                   @"ORDER BY fizbit ASC";
0

An alternative is to use any tool for removing line breaks. Write your string using any text editor, once you finished, paste your text here and copy it again in xcode.

1
  • 2
    No really a long term solution. What if you have to change it again later. Get's annoying fast, better to use the multi line techniqies already mentioned and format it directly in the file. Feb 6, 2020 at 16:43

Not the answer you're looking for? Browse other questions tagged or ask your own question.