[ios.base.storage] (original) (raw)

Effects: If parray is a null pointer, allocates an array of pointers to void of unspecified size and stores a pointer to its first element in parray.

The function then extends the array pointed at by parray as necessary to include the element_parray_[idx].

Each newly allocated element of the array is initialized to a null pointer.

The reference returned is invalid after any other operation on the object.

However, the value of the storage referred to is retained, so that until the next call tocopyfmt, callingpwordwith the same index yields another reference to the same value.

If the function fails263and*thisis a base class subobject of abasic_ios<>object or subobject, the effect is equivalent to callingbasic_ios<>​::​setstate(badbit)on the derived object (which may throwfailure).