resize

Function

resize

Changes the length.

Size resize(object, new_length [, resize_tag])

resize(file, new_length)

Parameters

object	A container. Types: char array, Pool, Segment, SimpleShape, std::basic_string, String, StringSet
new_length	The new length object will get. The new file size measured in bytes.
resize_tag	Specifies the strategy that is applied if the capacity of object is less than new_length. (optional) Types: Overflow Strategy Default: Specified by DefaultOverflowExplicit.
file	A File object. Types: File

Return Values

The new length length(object).

Metafunctions: Size

Remarks

This function can be used both for expanding and for shrinking object.

If new_length is too large for object (i.e. the capacity of object is too small), then object is expanded as far as possible. The resulting length of object could be less than new_length, depending on the type of object and the available storage.