• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<html>
2<head>
3<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4<title>basic_static_string::append (9 of 9 overloads)</title>
5<link rel="stylesheet" href="../../../../../../../../doc/src/boostbook.css" type="text/css">
6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
7<link rel="home" href="../../../../index.html" title="Boost.StaticString">
8<link rel="up" href="../append.html" title="basic_static_string::append">
9<link rel="prev" href="overload8.html" title="basic_static_string::append (8 of 9 overloads)">
10<link rel="next" href="../operator_plus__eq_.html" title="basic_static_string::operator+=">
11</head>
12<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
13<table cellpadding="2" width="100%"><tr>
14<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../../boost.png"></td>
15<td align="center"><a href="../../../../../../../../index.html">Home</a></td>
16<td align="center"><a href="../../../../../../../../libs/libraries.htm">Libraries</a></td>
17<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
18<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
19<td align="center"><a href="../../../../../../../../more/index.htm">More</a></td>
20</tr></table>
21<hr>
22<div class="spirit-nav">
23<a accesskey="p" href="overload8.html"><img src="../../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../append.html"><img src="../../../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../operator_plus__eq_.html"><img src="../../../../../../../../doc/src/images/next.png" alt="Next"></a>
24</div>
25<div class="section">
26<div class="titlepage"><div><div><h5 class="title">
27<a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9"></a><a class="link" href="overload9.html" title="basic_static_string::append (9 of 9 overloads)">basic_static_string::append
28          (9 of 9 overloads)</a>
29</h5></div></div></div>
30<p>
31            Append to the string.
32          </p>
33<h6>
34<a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.h0"></a>
35            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.synopsis"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.append.overload9.synopsis">Synopsis</a>
36          </h6>
37<pre class="programlisting"><span class="keyword">template</span><span class="special">&lt;</span>
38    <span class="special">[</span><span class="identifier">role</span> <span class="identifier">red</span> <span class="identifier">error</span><span class="special">.</span><span class="identifier">param</span> <span class="identifier">neither</span> <span class="identifier">has</span> <span class="identifier">a</span> <span class="identifier">declname</span> <span class="identifier">nor</span> <span class="identifier">a</span> <span class="char">'class '</span> <span class="identifier">prefix</span> <span class="identifier">in</span> <span class="identifier">the</span> <span class="identifier">type</span><span class="special">][</span><span class="identifier">role</span> <span class="identifier">red</span> <span class="identifier">error</span><span class="special">.</span><span class="identifier">param</span> <span class="identifier">neither</span> <span class="identifier">has</span> <span class="identifier">a</span> <span class="identifier">declname</span> <span class="identifier">nor</span> <span class="identifier">a</span> <span class="char">'class '</span> <span class="identifier">prefix</span> <span class="identifier">in</span> <span class="identifier">the</span> <span class="identifier">type</span><span class="special">][</span><span class="identifier">role</span> <span class="identifier">red</span> <span class="identifier">error</span><span class="special">.</span><span class="identifier">param</span> <span class="identifier">neither</span> <span class="identifier">has</span> <span class="identifier">a</span> <span class="identifier">declname</span> <span class="identifier">nor</span> <span class="identifier">a</span> <span class="char">'class '</span> <span class="identifier">prefix</span> <span class="identifier">in</span> <span class="identifier">the</span> <span class="identifier">type</span><span class="special">][</span><span class="identifier">role</span> <span class="identifier">red</span> <span class="identifier">error</span><span class="special">.</span><span class="identifier">param</span> <span class="identifier">neither</span> <span class="identifier">has</span> <span class="identifier">a</span> <span class="identifier">declname</span> <span class="identifier">nor</span> <span class="identifier">a</span> <span class="char">'class '</span> <span class="identifier">prefix</span> <span class="identifier">in</span> <span class="identifier">the</span> <span class="identifier">type</span><span class="special">]&gt;</span>
39<span class="keyword">constexpr</span> <span class="identifier">basic_static_string</span><span class="special">&amp;</span>
40<span class="identifier">append</span><span class="special">(</span>
41    <span class="keyword">const</span> <span class="identifier">T</span><span class="special">&amp;</span> <span class="identifier">t</span><span class="special">,</span>
42    <span class="identifier">size_type</span> <span class="identifier">pos</span><span class="special">,</span>
43    <span class="identifier">size_type</span> <span class="identifier">count</span> <span class="special">=</span> <a class="link" href="../npos.html" title="basic_static_string::npos">npos</a><span class="special">);</span>
44</pre>
45<h6>
46<a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.h1"></a>
47            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.description"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.append.overload9.description">Description</a>
48          </h6>
49<p>
50            Appends the substring <code class="computeroutput"><span class="identifier">sv</span></code>
51            to the end of the string, where <code class="computeroutput"><span class="identifier">sv</span></code>
52            is <code class="computeroutput"><span class="identifier">string_view_type</span><span class="special">(</span><span class="identifier">t</span><span class="special">).</span><span class="identifier">substr</span><span class="special">(</span><span class="identifier">pos</span><span class="special">,</span> <span class="identifier">count</span><span class="special">)</span></code>.
53          </p>
54<h6>
55<a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.h2"></a>
56            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.exception_safety"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.append.overload9.exception_safety">Exception
57            Safety</a>
58          </h6>
59<p>
60            Strong guarantee.
61          </p>
62<h6>
63<a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.h3"></a>
64            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.template_parameters"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.append.overload9.template_parameters">Template
65            Parameters</a>
66          </h6>
67<div class="informaltable"><table class="table">
68<colgroup>
69<col>
70<col>
71</colgroup>
72<thead><tr>
73<th>
74                    <p>
75                      Type
76                    </p>
77                  </th>
78<th>
79                    <p>
80                      Description
81                    </p>
82                  </th>
83</tr></thead>
84<tbody><tr>
85<td>
86                    <p>
87                      <code class="computeroutput"><span class="identifier">T</span></code>
88                    </p>
89                  </td>
90<td>
91                    <p>
92                      The type of the object to convert.
93                    </p>
94                  </td>
95</tr></tbody>
96</table></div>
97<h6>
98<a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.h4"></a>
99            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.constraints"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.append.overload9.constraints">Constraints</a>
100          </h6>
101<pre class="programlisting"><span class="identifier">std</span><span class="special">::</span><span class="identifier">is_convertible</span><span class="special">&lt;</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;,</span> <span class="identifier">string_view</span><span class="special">&gt;::</span><span class="identifier">value</span> <span class="special">&amp;&amp;</span>
102<span class="special">!</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">is_convertible</span><span class="special">&lt;</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;,</span> <span class="keyword">char</span> <span class="keyword">const</span><span class="special">*&gt;::</span><span class="identifier">value</span>
103</pre>
104<h6>
105<a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.h5"></a>
106            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.return_value"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.append.overload9.return_value">Return
107            Value</a>
108          </h6>
109<p>
110            <code class="computeroutput"><span class="special">*</span><span class="keyword">this</span></code>
111          </p>
112<h6>
113<a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.h6"></a>
114            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.parameters"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.append.overload9.parameters">Parameters</a>
115          </h6>
116<div class="informaltable"><table class="table">
117<colgroup>
118<col>
119<col>
120</colgroup>
121<thead><tr>
122<th>
123                    <p>
124                      Name
125                    </p>
126                  </th>
127<th>
128                    <p>
129                      Description
130                    </p>
131                  </th>
132</tr></thead>
133<tbody>
134<tr>
135<td>
136                    <p>
137                      <code class="computeroutput"><span class="identifier">t</span></code>
138                    </p>
139                  </td>
140<td>
141                    <p>
142                      The object to append.
143                    </p>
144                  </td>
145</tr>
146<tr>
147<td>
148                    <p>
149                      <code class="computeroutput"><span class="identifier">pos</span></code>
150                    </p>
151                  </td>
152<td>
153                    <p>
154                      The index at which to begin the substring.
155                    </p>
156                  </td>
157</tr>
158<tr>
159<td>
160                    <p>
161                      <code class="computeroutput"><span class="identifier">count</span></code>
162                    </p>
163                  </td>
164<td>
165                    <p>
166                      The size of the substring. The default argument for this parameter
167                      is <a class="link" href="../npos.html" title="basic_static_string::npos"><code class="computeroutput"><span class="identifier">npos</span></code></a>.
168                    </p>
169                  </td>
170</tr>
171</tbody>
172</table></div>
173<h6>
174<a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.h7"></a>
175            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.append.overload9.exceptions"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.append.overload9.exceptions">Exceptions</a>
176          </h6>
177<div class="informaltable"><table class="table">
178<colgroup>
179<col>
180<col>
181</colgroup>
182<thead><tr>
183<th>
184                    <p>
185                      Type
186                    </p>
187                  </th>
188<th>
189                    <p>
190                      Thrown On
191                    </p>
192                  </th>
193</tr></thead>
194<tbody><tr>
195<td>
196                    <p>
197                      <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">length_error</span></code>
198                    </p>
199                  </td>
200<td>
201                    <p>
202                      <a class="link" href="../size.html" title="basic_static_string::size"><code class="computeroutput"><span class="identifier">size</span><span class="special">()</span></code></a>
203                      + sv.size() &gt; <a class="link" href="../max_size.html" title="basic_static_string::max_size"><code class="computeroutput"><span class="identifier">max_size</span><span class="special">()</span></code></a>
204                    </p>
205                  </td>
206</tr></tbody>
207</table></div>
208</div>
209<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
210<td align="left"></td>
211<td align="right"><div class="copyright-footer">Copyright © 2019, 2020 Krystian Stasiowski<br>Copyright © 2016-2019 Vinnie
212      Falco<p>
213        Distributed under the Boost Software License, Version 1.0. (See accompanying
214        file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
215      </p>
216</div></td>
217</tr></table>
218<hr>
219<div class="spirit-nav">
220<a accesskey="p" href="overload8.html"><img src="../../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../append.html"><img src="../../../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../index.html"><img src="../../../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../operator_plus__eq_.html"><img src="../../../../../../../../doc/src/images/next.png" alt="Next"></a>
221</div>
222</body>
223</html>
224