AllocateStringA()

char* Chusov::String::AllocateStringA ( std::size_t  cch )

noexcept

Allocates an uninitialized string of the specified size, in bytes, plus a room for a terminating zero.

Parameters

cch	is a size of the string to be allocated including the terminating 0.

Returns

On success the function returns a pointer to the allocated multibyte string. The content of the allocated string is not specified. The returned string buffer must be freed using one of the free functions defined in the Chusov::Memory or Chusov::String namespace. On failure the function returns NULL. Use GetLastChsvError function to get extended error information.

Remarks

The function is actually implemented as a wrap over the AllocateData function therefore it has analogous call rules as the other allocation functions of the Chusov::Memory namespace.

The Chusov::String namespace provides analogous functions for wide strings for every counterpart working with multibyte strings. The analogues are declared with a 'W' (instead of 'A') suffix at the end of the name, e.g. AllocateStringW, FreeStringW, etc.

See also

AllocateData;
AllocateAndFormatStringA;
AllocateAndFormatStringByTagsA;
FreeStringA;
SecureFreeStringA.