[#C50486B42C84C8E6C81A5D4356B9291CDF0F3A8F]

<div id="C50486B42C84C8E6C81A5D4356B9291CDF0F3A8F">
    <div>
        <h2>Function <a href="#">arg</a>::
prepare</h2>
        <p><span>Return a modifiable character buffer</span></p>


    </div>

    <div>
        <h3>Synopsis</h3>
        <div>
            <code>
                            </code>
        </div>
        <pre class="source-code cpp">
            virtual
char*
prepare(std::size_t n) = 0;
        </pre>
    </div>

    <div>
        <h3>Description</h3>
        <p><span>This function attempts to obtain a</span> <span>character buffer with space for at</span>
<span>least `n` characters. Upon success,</span>
<span>a pointer to the beginning of the</span>
<span>buffer is returned. Ownership is not</span>
<span>transferred; the caller should not</span>
<span>attempt to free the storage. The</span>
<span>buffer shall remain valid until</span>
<span>`this` is destroyed.</span></p>

<div>
<h4>NOTE</h4>
<p><span>This function may only be called once.</span>
<span>After invoking the function, the only</span>
<span>valid operation is destruction.</span></p>

</div>

    </div>



</div>