resize

Function

resize

Changes the length.

resize(file, new_length)

Size resize(object, new_length [, resize_tag])

Parameters

file	A File object. Types: File
new_length	The new file size measured in bytes. The new length object will get.
object	A container. Types: char array, Pool, Segment, SimpleShape, std::basic_string, String, StringSet
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.

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.