• 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::assign (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="../assign.html" title="basic_static_string::assign">
9<link rel="prev" href="overload8.html" title="basic_static_string::assign (8 of 9 overloads)">
10<link rel="next" href="../at.html" title="basic_static_string::at">
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="../assign.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="../at.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.assign.overload9"></a><a class="link" href="overload9.html" title="basic_static_string::assign (9 of 9 overloads)">basic_static_string::assign
28          (9 of 9 overloads)</a>
29</h5></div></div></div>
30<p>
31            Assign to the string.
32          </p>
33<h6>
34<a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.h0"></a>
35            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.synopsis"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.assign.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="identifier">basic_static_string</span><span class="special">&amp;</span>
40<span class="identifier">assign</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.assign.overload9.h1"></a>
47            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.description"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.assign.overload9.description">Description</a>
48          </h6>
49<p>
50            Replaces the contents with those of the substring <code class="computeroutput"><span class="identifier">sv</span></code>,
51            where <code class="computeroutput"><span class="identifier">sv</span></code> 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>.
52          </p>
53<h6>
54<a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.h2"></a>
55            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.complexity"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.assign.overload9.complexity">Complexity</a>
56          </h6>
57<p>
58            Linear in <code class="computeroutput"><span class="identifier">sv</span><span class="special">.</span><span class="identifier">size</span><span class="special">()</span></code>.
59          </p>
60<h6>
61<a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.h3"></a>
62            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.exception_safety"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.assign.overload9.exception_safety">Exception
63            Safety</a>
64          </h6>
65<p>
66            Strong guarantee.
67          </p>
68<h6>
69<a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.h4"></a>
70            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.remarks"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.assign.overload9.remarks">Remarks</a>
71          </h6>
72<p>
73            The view can contain null characters.
74          </p>
75<h6>
76<a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.h5"></a>
77            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.template_parameters"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.assign.overload9.template_parameters">Template
78            Parameters</a>
79          </h6>
80<div class="informaltable"><table class="table">
81<colgroup>
82<col>
83<col>
84</colgroup>
85<thead><tr>
86<th>
87                    <p>
88                      Type
89                    </p>
90                  </th>
91<th>
92                    <p>
93                      Description
94                    </p>
95                  </th>
96</tr></thead>
97<tbody><tr>
98<td>
99                    <p>
100                      <code class="computeroutput"><span class="identifier">T</span></code>
101                    </p>
102                  </td>
103<td>
104                    <p>
105                      A type convertible to <code class="computeroutput"><span class="identifier">string_view_type</span></code>.
106                    </p>
107                  </td>
108</tr></tbody>
109</table></div>
110<h6>
111<a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.h6"></a>
112            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.constraints"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.assign.overload9.constraints">Constraints</a>
113          </h6>
114<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="keyword">const</span> <span class="identifier">T</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>
115<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="keyword">const</span> <span class="identifier">T</span><span class="special">&amp;,</span> <span class="keyword">const</span> <span class="identifier">CharT</span><span class="special">*&gt;::</span><span class="identifier">value</span>
116</pre>
117<h6>
118<a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.h7"></a>
119            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.return_value"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.assign.overload9.return_value">Return
120            Value</a>
121          </h6>
122<p>
123            <code class="computeroutput"><span class="special">*</span><span class="keyword">this</span></code>
124          </p>
125<h6>
126<a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.h8"></a>
127            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.parameters"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.assign.overload9.parameters">Parameters</a>
128          </h6>
129<div class="informaltable"><table class="table">
130<colgroup>
131<col>
132<col>
133</colgroup>
134<thead><tr>
135<th>
136                    <p>
137                      Name
138                    </p>
139                  </th>
140<th>
141                    <p>
142                      Description
143                    </p>
144                  </th>
145</tr></thead>
146<tbody>
147<tr>
148<td>
149                    <p>
150                      <code class="computeroutput"><span class="identifier">t</span></code>
151                    </p>
152                  </td>
153<td>
154                    <p>
155                      The object to assign from.
156                    </p>
157                  </td>
158</tr>
159<tr>
160<td>
161                    <p>
162                      <code class="computeroutput"><span class="identifier">pos</span></code>
163                    </p>
164                  </td>
165<td>
166                    <p>
167                      The index at which to begin the substring.
168                    </p>
169                  </td>
170</tr>
171<tr>
172<td>
173                    <p>
174                      <code class="computeroutput"><span class="identifier">count</span></code>
175                    </p>
176                  </td>
177<td>
178                    <p>
179                      The size of the substring. The default argument for this parameter
180                      is <a class="link" href="../npos.html" title="basic_static_string::npos"><code class="computeroutput"><span class="identifier">npos</span></code></a>.
181                    </p>
182                  </td>
183</tr>
184</tbody>
185</table></div>
186<h6>
187<a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.h9"></a>
188            <span class="phrase"><a name="static_string.ref.boost__static_strings__basic_static_string.assign.overload9.exceptions"></a></span><a class="link" href="overload9.html#static_string.ref.boost__static_strings__basic_static_string.assign.overload9.exceptions">Exceptions</a>
189          </h6>
190<div class="informaltable"><table class="table">
191<colgroup>
192<col>
193<col>
194</colgroup>
195<thead><tr>
196<th>
197                    <p>
198                      Type
199                    </p>
200                  </th>
201<th>
202                    <p>
203                      Thrown On
204                    </p>
205                  </th>
206</tr></thead>
207<tbody><tr>
208<td>
209                    <p>
210                      <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">length_error</span></code>
211                    </p>
212                  </td>
213<td>
214                    <p>
215                      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>.
216                    </p>
217                  </td>
218</tr></tbody>
219</table></div>
220</div>
221<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
222<td align="left"></td>
223<td align="right"><div class="copyright-footer">Copyright © 2019, 2020 Krystian Stasiowski<br>Copyright © 2016-2019 Vinnie
224      Falco<p>
225        Distributed under the Boost Software License, Version 1.0. (See accompanying
226        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>)
227      </p>
228</div></td>
229</tr></table>
230<hr>
231<div class="spirit-nav">
232<a accesskey="p" href="overload8.html"><img src="../../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../assign.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="../at.html"><img src="../../../../../../../../doc/src/images/next.png" alt="Next"></a>
233</div>
234</body>
235</html>
236