C++ streambuf - pubimbue

Description

It is an imbue locale and associates loc to the stream buffer.

Declaration

Following is the declaration for std::basic_streambuf::pubimbue.

locale pubimbue (const locale& loc);

Parameters

loc − locale object to imbue to the stream buffer as its new associated locale.

Return Value

Returns the locale object associated to the stream buffer before the call.

Exceptions

Basic guarantee − if an exception is thrown, the stream buffer is in a valid state.

Data races

It modifies the stream buffer object.