prepare

Return a modifiable character buffer

Synopsis

char* prepare( size_t n);

Declared in file <boost/url/grammar/string_token.hpp> at line 68

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.