[#boost-urls-string_token-arg-prepare]
= xref:boost.adoc[boost]::xref:boost/urls.adoc[urls]::xref:boost/urls/string_token.adoc[string_token]::xref:boost/urls/string_token/arg.adoc[arg]::prepare
:relfileprefix: ../../../../
:mrdocs:


Return a modifiable character buffer

== Synopsis


Declared in `<https://www.github.com/boostorg/url/blob/develop/include/boost/url/grammar/string_token.hpp#L70[boost/url/grammar/string_token.hpp]>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
virtual
char*
prepare(std::size_t n) = 0;
----

== Description


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

[NOTE]
This function may only be called once.        After invoking the function, the only        valid operation is destruction.





[.small]#Created with https://www.mrdocs.com[MrDocs]#