Append characters to the output sequence.

Synopsis

Declared in <bslstl_stringbuf.h>

virtual
std::streamsize
xsputn(
    char_type const* inputString,
    std::streamsize numCharacters);

Description

Append the specified numCharacters from the specified inputString to the output sequence starting at the current output position (pptr). Update the current output position of this string buffer to refer to the last appended character. Return the number of characters that were appended. The behavior is undefined unless inputString refers to a contiguous sequence of at least numCharacters characters.

Return Value

number of characters that were appended

Parameters

Name

Description

inputString

characters to append to the output sequence

numCharacters

number of characters to append

Created with MrDocs