aboutsummaryrefslogtreecommitdiff
path: root/coverage-report/ccan/str/str.h.gcov.html
blob: 422081498bed479bab251544339681e7ce0f230d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html lang="en">

<head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <title>LCOV - skiboot.info - ccan/str/str.h</title>
  <link rel="stylesheet" type="text/css" href="../../gcov.css">
</head>

<body>

  <table width="100%" border=0 cellspacing=0 cellpadding=0>
    <tr><td class="title">LCOV - code coverage report</td></tr>
    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>

    <tr>
      <td width="100%">
        <table cellpadding=1 border=0 width="100%">
          <tr>
            <td width="10%" class="headerItem">Current view:</td>
            <td width="35%" class="headerValue"><a href="../../index.html">top level</a> - <a href="index.html">ccan/str</a> - str.h<span style="font-size: 80%;"> (source / <a href="str.h.func-sort-c.html">functions</a>)</span></td>
            <td width="5%"></td>
            <td width="15%"></td>
            <td width="10%" class="headerCovTableHead">Hit</td>
            <td width="10%" class="headerCovTableHead">Total</td>
            <td width="15%" class="headerCovTableHead">Coverage</td>
          </tr>
          <tr>
            <td class="headerItem">Test:</td>
            <td class="headerValue">skiboot.info</td>
            <td></td>
            <td class="headerItem">Lines:</td>
            <td class="headerCovTableEntry">4</td>
            <td class="headerCovTableEntry">4</td>
            <td class="headerCovTableEntryHi">100.0 %</td>
          </tr>
          <tr>
            <td class="headerItem">Date:</td>
            <td class="headerValue">2022-07-05 16:01:27</td>
            <td></td>
            <td class="headerItem">Functions:</td>
            <td class="headerCovTableEntry">1</td>
            <td class="headerCovTableEntry">1</td>
            <td class="headerCovTableEntryHi">100.0 %</td>
          </tr>
          <tr>
            <td></td>
            <td></td>
            <td></td>
            <td class="headerItem">Branches:</td>
            <td class="headerCovTableEntry">0</td>
            <td class="headerCovTableEntry">0</td>
            <td class="headerCovTableEntryHi">-</td>
          </tr>
          <tr><td><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
        </table>
      </td>
    </tr>

    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
  </table>

  <table cellpadding=0 cellspacing=0 border=0>
    <tr>
      <td><br></td>
    </tr>
    <tr>
      <td>
<pre class="sourceHeading">           Branch data     Line data    Source code</pre>
<pre class="source">
<a name="1"><span class="lineNum">       1 </span>                :            : /* CC0 (Public domain) - see LICENSE file for details */</a>
<a name="2"><span class="lineNum">       2 </span>                :            : #ifndef CCAN_STR_H</a>
<a name="3"><span class="lineNum">       3 </span>                :            : #define CCAN_STR_H</a>
<a name="4"><span class="lineNum">       4 </span>                :            : #include &quot;config.h&quot;</a>
<a name="5"><span class="lineNum">       5 </span>                :            : #include &lt;string.h&gt;</a>
<a name="6"><span class="lineNum">       6 </span>                :            : #include &lt;stdbool.h&gt;</a>
<a name="7"><span class="lineNum">       7 </span>                :            : #include &lt;limits.h&gt;</a>
<a name="8"><span class="lineNum">       8 </span>                :            : #include &lt;ctype.h&gt;</a>
<a name="9"><span class="lineNum">       9 </span>                :            : </a>
<a name="10"><span class="lineNum">      10 </span>                :            : /**</a>
<a name="11"><span class="lineNum">      11 </span>                :            :  * streq - Are two strings equal?</a>
<a name="12"><span class="lineNum">      12 </span>                :            :  * @a: first string</a>
<a name="13"><span class="lineNum">      13 </span>                :            :  * @b: first string</a>
<a name="14"><span class="lineNum">      14 </span>                :            :  *</a>
<a name="15"><span class="lineNum">      15 </span>                :            :  * This macro is arguably more readable than &quot;!strcmp(a, b)&quot;.</a>
<a name="16"><span class="lineNum">      16 </span>                :            :  *</a>
<a name="17"><span class="lineNum">      17 </span>                :            :  * Example:</a>
<a name="18"><span class="lineNum">      18 </span>                :            :  *      if (streq(somestring, &quot;&quot;))</a>
<a name="19"><span class="lineNum">      19 </span>                :            :  *              printf(&quot;String is empty!\n&quot;);</a>
<a name="20"><span class="lineNum">      20 </span>                :            :  */</a>
<a name="21"><span class="lineNum">      21 </span>                :            : #define streq(a,b) (strcmp((a),(b)) == 0)</a>
<a name="22"><span class="lineNum">      22 </span>                :            : </a>
<a name="23"><span class="lineNum">      23 </span>                :            : /**</a>
<a name="24"><span class="lineNum">      24 </span>                :            :  * strstarts - Does this string start with this prefix?</a>
<a name="25"><span class="lineNum">      25 </span>                :            :  * @str: string to test</a>
<a name="26"><span class="lineNum">      26 </span>                :            :  * @prefix: prefix to look for at start of str</a>
<a name="27"><span class="lineNum">      27 </span>                :            :  *</a>
<a name="28"><span class="lineNum">      28 </span>                :            :  * Example:</a>
<a name="29"><span class="lineNum">      29 </span>                :            :  *      if (strstarts(somestring, &quot;foo&quot;))</a>
<a name="30"><span class="lineNum">      30 </span>                :            :  *              printf(&quot;String %s begins with 'foo'!\n&quot;, somestring);</a>
<a name="31"><span class="lineNum">      31 </span>                :            :  */</a>
<a name="32"><span class="lineNum">      32 </span>                :            : #define strstarts(str,prefix) (strncmp((str),(prefix),strlen(prefix)) == 0)</a>
<a name="33"><span class="lineNum">      33 </span>                :            : </a>
<a name="34"><span class="lineNum">      34 </span>                :            : /**</a>
<a name="35"><span class="lineNum">      35 </span>                :            :  * strends - Does this string end with this postfix?</a>
<a name="36"><span class="lineNum">      36 </span>                :            :  * @str: string to test</a>
<a name="37"><span class="lineNum">      37 </span>                :            :  * @postfix: postfix to look for at end of str</a>
<a name="38"><span class="lineNum">      38 </span>                :            :  *</a>
<a name="39"><span class="lineNum">      39 </span>                :            :  * Example:</a>
<a name="40"><span class="lineNum">      40 </span>                :            :  *      if (strends(somestring, &quot;foo&quot;))</a>
<a name="41"><span class="lineNum">      41 </span>                :            :  *              printf(&quot;String %s end with 'foo'!\n&quot;, somestring);</a>
<a name="42"><span class="lineNum">      42 </span>                :            :  */</a>
<a name="43"><span class="lineNum">      43 </span>                :<span class="lineCov">      14406 : static inline bool strends(const char *str, const char *postfix)</span></a>
<a name="44"><span class="lineNum">      44 </span>                :            : {</a>
<a name="45"><span class="lineNum">      45 </span>                :<span class="lineCov">      14406 :         if (strlen(str) &lt; strlen(postfix))</span></a>
<a name="46"><span class="lineNum">      46 </span>                :<span class="lineCov">       5520 :                 return false;</span></a>
<a name="47"><span class="lineNum">      47 </span>                :            : </a>
<a name="48"><span class="lineNum">      48 </span>                :<span class="lineCov">       8886 :         return streq(str + strlen(str) - strlen(postfix), postfix);</span></a>
<a name="49"><span class="lineNum">      49 </span>                :            : }</a>
<a name="50"><span class="lineNum">      50 </span>                :            : </a>
<a name="51"><span class="lineNum">      51 </span>                :            : /**</a>
<a name="52"><span class="lineNum">      52 </span>                :            :  * stringify - Turn expression into a string literal</a>
<a name="53"><span class="lineNum">      53 </span>                :            :  * @expr: any C expression</a>
<a name="54"><span class="lineNum">      54 </span>                :            :  *</a>
<a name="55"><span class="lineNum">      55 </span>                :            :  * Example:</a>
<a name="56"><span class="lineNum">      56 </span>                :            :  *      #define PRINT_COND_IF_FALSE(cond) \</a>
<a name="57"><span class="lineNum">      57 </span>                :            :  *              ((cond) || printf(&quot;%s is false!&quot;, stringify(cond)))</a>
<a name="58"><span class="lineNum">      58 </span>                :            :  */</a>
<a name="59"><span class="lineNum">      59 </span>                :            : #define stringify(expr)         stringify_1(expr)</a>
<a name="60"><span class="lineNum">      60 </span>                :            : /* Double-indirection required to stringify expansions */</a>
<a name="61"><span class="lineNum">      61 </span>                :            : #define stringify_1(expr)       #expr</a>
<a name="62"><span class="lineNum">      62 </span>                :            : </a>
<a name="63"><span class="lineNum">      63 </span>                :            : /**</a>
<a name="64"><span class="lineNum">      64 </span>                :            :  * strcount - Count number of (non-overlapping) occurrences of a substring.</a>
<a name="65"><span class="lineNum">      65 </span>                :            :  * @haystack: a C string</a>
<a name="66"><span class="lineNum">      66 </span>                :            :  * @needle: a substring</a>
<a name="67"><span class="lineNum">      67 </span>                :            :  *</a>
<a name="68"><span class="lineNum">      68 </span>                :            :  * Example:</a>
<a name="69"><span class="lineNum">      69 </span>                :            :  *      assert(strcount(&quot;aaa aaa&quot;, &quot;a&quot;) == 6);</a>
<a name="70"><span class="lineNum">      70 </span>                :            :  *      assert(strcount(&quot;aaa aaa&quot;, &quot;ab&quot;) == 0);</a>
<a name="71"><span class="lineNum">      71 </span>                :            :  *      assert(strcount(&quot;aaa aaa&quot;, &quot;aa&quot;) == 2);</a>
<a name="72"><span class="lineNum">      72 </span>                :            :  */</a>
<a name="73"><span class="lineNum">      73 </span>                :            : size_t strcount(const char *haystack, const char *needle);</a>
<a name="74"><span class="lineNum">      74 </span>                :            : </a>
<a name="75"><span class="lineNum">      75 </span>                :            : /**</a>
<a name="76"><span class="lineNum">      76 </span>                :            :  * STR_MAX_CHARS - Maximum possible size of numeric string for this type.</a>
<a name="77"><span class="lineNum">      77 </span>                :            :  * @type_or_expr: a pointer or integer type or expression.</a>
<a name="78"><span class="lineNum">      78 </span>                :            :  *</a>
<a name="79"><span class="lineNum">      79 </span>                :            :  * This provides enough space for a nul-terminated string which represents the</a>
<a name="80"><span class="lineNum">      80 </span>                :            :  * largest possible value for the type or expression.</a>
<a name="81"><span class="lineNum">      81 </span>                :            :  *</a>
<a name="82"><span class="lineNum">      82 </span>                :            :  * Note: The implementation adds extra space so hex values or negative</a>
<a name="83"><span class="lineNum">      83 </span>                :            :  * values will fit (eg. sprintf(... &quot;%p&quot;). )</a>
<a name="84"><span class="lineNum">      84 </span>                :            :  *</a>
<a name="85"><span class="lineNum">      85 </span>                :            :  * Example:</a>
<a name="86"><span class="lineNum">      86 </span>                :            :  *      char str[STR_MAX_CHARS(int)];</a>
<a name="87"><span class="lineNum">      87 </span>                :            :  *</a>
<a name="88"><span class="lineNum">      88 </span>                :            :  *      sprintf(str, &quot;%i&quot;, 7);</a>
<a name="89"><span class="lineNum">      89 </span>                :            :  */</a>
<a name="90"><span class="lineNum">      90 </span>                :            : #define STR_MAX_CHARS(type_or_expr)                             \</a>
<a name="91"><span class="lineNum">      91 </span>                :            :         ((sizeof(type_or_expr) * CHAR_BIT + 8) / 9 * 3 + 2      \</a>
<a name="92"><span class="lineNum">      92 </span>                :            :          + STR_MAX_CHARS_TCHECK_(type_or_expr))</a>
<a name="93"><span class="lineNum">      93 </span>                :            : </a>
<a name="94"><span class="lineNum">      94 </span>                :            : #if HAVE_TYPEOF</a>
<a name="95"><span class="lineNum">      95 </span>                :            : /* Only a simple type can have 0 assigned, so test that. */</a>
<a name="96"><span class="lineNum">      96 </span>                :            : #define STR_MAX_CHARS_TCHECK_(type_or_expr)             \</a>
<a name="97"><span class="lineNum">      97 </span>                :            :         (sizeof(({ typeof(type_or_expr) x = 0; x; }))*0)</a>
<a name="98"><span class="lineNum">      98 </span>                :            : #else</a>
<a name="99"><span class="lineNum">      99 </span>                :            : #define STR_MAX_CHARS_TCHECK_(type_or_expr) 0</a>
<a name="100"><span class="lineNum">     100 </span>                :            : #endif</a>
<a name="101"><span class="lineNum">     101 </span>                :            : </a>
<a name="102"><span class="lineNum">     102 </span>                :            : #include &lt;ccan/str/str_debug.h&gt;</a>
<a name="103"><span class="lineNum">     103 </span>                :            : </a>
<a name="104"><span class="lineNum">     104 </span>                :            : /* These checks force things out of line, hence they are under DEBUG. */</a>
<a name="105"><span class="lineNum">     105 </span>                :            : #ifdef CCAN_STR_DEBUG</a>
<a name="106"><span class="lineNum">     106 </span>                :            : #include &lt;ccan/build_assert/build_assert.h&gt;</a>
<a name="107"><span class="lineNum">     107 </span>                :            : </a>
<a name="108"><span class="lineNum">     108 </span>                :            : /* You can use a char if char is unsigned. */</a>
<a name="109"><span class="lineNum">     109 </span>                :            : #if HAVE_BUILTIN_TYPES_COMPATIBLE_P &amp;&amp; HAVE_TYPEOF</a>
<a name="110"><span class="lineNum">     110 </span>                :            : #define str_check_arg_(i)                                               \</a>
<a name="111"><span class="lineNum">     111 </span>                :            :         ((i) + BUILD_ASSERT_OR_ZERO(!__builtin_types_compatible_p(typeof(i), \</a>
<a name="112"><span class="lineNum">     112 </span>                :            :                                                                   char) \</a>
<a name="113"><span class="lineNum">     113 </span>                :            :                                     || (char)255 &gt; 0))</a>
<a name="114"><span class="lineNum">     114 </span>                :            : #else</a>
<a name="115"><span class="lineNum">     115 </span>                :            : #define str_check_arg_(i) (i)</a>
<a name="116"><span class="lineNum">     116 </span>                :            : #endif</a>
<a name="117"><span class="lineNum">     117 </span>                :            : </a>
<a name="118"><span class="lineNum">     118 </span>                :            : #if HAVE_TYPEOF</a>
<a name="119"><span class="lineNum">     119 </span>                :            : /* With GNU magic, we can make const-respecting standard string functions. */</a>
<a name="120"><span class="lineNum">     120 </span>                :            : #undef strstr</a>
<a name="121"><span class="lineNum">     121 </span>                :            : #undef strchr</a>
<a name="122"><span class="lineNum">     122 </span>                :            : #undef strrchr</a>
<a name="123"><span class="lineNum">     123 </span>                :            : </a>
<a name="124"><span class="lineNum">     124 </span>                :            : /* + 0 is needed to decay array into pointer. */</a>
<a name="125"><span class="lineNum">     125 </span>                :            : #define strstr(haystack, needle)                                        \</a>
<a name="126"><span class="lineNum">     126 </span>                :            :         ((typeof((haystack) + 0))str_strstr((haystack), (needle)))</a>
<a name="127"><span class="lineNum">     127 </span>                :            : #define strchr(haystack, c)                                     \</a>
<a name="128"><span class="lineNum">     128 </span>                :            :         ((typeof((haystack) + 0))str_strchr((haystack), (c)))</a>
<a name="129"><span class="lineNum">     129 </span>                :            : #define strrchr(haystack, c)                                    \</a>
<a name="130"><span class="lineNum">     130 </span>                :            :         ((typeof((haystack) + 0))str_strrchr((haystack), (c)))</a>
<a name="131"><span class="lineNum">     131 </span>                :            : #endif</a>
<a name="132"><span class="lineNum">     132 </span>                :            : #endif /* CCAN_STR_DEBUG */</a>
<a name="133"><span class="lineNum">     133 </span>                :            : </a>
<a name="134"><span class="lineNum">     134 </span>                :            : #endif /* CCAN_STR_H */</a>
</pre>
      </td>
    </tr>
  </table>
  <br>

  <table width="100%" border=0 cellspacing=0 cellpadding=0>
    <tr><td class="ruler"><img src="../../glass.png" width=3 height=3 alt=""></td></tr>
    <tr><td class="versionInfo">Generated by: <a href="http://ltp.sourceforge.net/coverage/lcov.php" target="_parent">LCOV version 1.14</a></td></tr>
  </table>
  <br>

</body>
</html>