Debian Codegraph @

clang-tools-extra/docs/clang-tidy/checks/performance/inefficient-string-concatenation.rst

raw
1 .. title:: clang-tidy - performance-inefficient-string-concatenation
2
3 performance-inefficient-string-concatenation
4 ============================================
5
6 This check warns about the performance overhead arising from concatenating
7 strings using the ``operator+``, for instance:
8
9 .. code-block:: c++
10
11 std::string a("Foo"), b("Bar");
12 a = a + b;
13
14 Instead of this structure you should use ``operator+=`` or ``std::string``'s
15 (``std::basic_string``) class member function ``append()``. For instance:
16
17 .. code-block:: c++
18
19 std::string a("Foo"), b("Baz");
20 for (int i = 0; i < 20000; ++i) {
21 a = a + "Bar" + b;
22 }
23
24 Could be rewritten in a greatly more efficient way like:
25
26 .. code-block:: c++
27
28 std::string a("Foo"), b("Baz");
29 for (int i = 0; i < 20000; ++i) {
30 a.append("Bar").append(b);
31 }
32
33 And this can be rewritten too:
34
35 .. code-block:: c++
36
37 void f(const std::string&) {}
38 std::string a("Foo"), b("Baz");
39 void g() {
40 f(a + "Bar" + b);
41 }
42
43 In a slightly more efficient way like:
44
45 .. code-block:: c++
46
47 void f(const std::string&) {}
48 std::string a("Foo"), b("Baz");
49 void g() {
50 f(std::string(a).append("Bar").append(b));
51 }
52
53 Options
54 -------
55
56 .. option:: StrictMode
57
58 When `false`, the check will only check the string usage in ``while``, ``for``
59 and ``for-range`` statements. Default is `false`.