Return a modifiable character buffer

Synopsis

Declared in header <boost/url/grammar/string_token.hpp>

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.