fill

Function

fill

Resizes and fills a container.

Size fill(object, new_length, value [, resize_tag])

Parameters

object	A container. Types: char array, std::basic_string, String
new_length	The new length object will get.
value	Value that is copied if new items are created in object. Remarks: If the value argument is omitted, the default constructor is used to create new items in object.
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.