[#BloombergLP-bdlsb-OverflowMemOutput-sputn]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlsb.adoc[bdlsb]::xref:BloombergLP/bdlsb/OverflowMemOutput.adoc[OverflowMemOutput]::sputn
:relfileprefix: ../../../
:mrdocs:

Write characters from the specified source to this buffer.

== Synopsis

Declared in `<bdlsb_overflowmemoutput.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::streamsize
sputn(
    char const* source,
    std::streamsize length);
----

== Description

Write the specified `length` characters from the specified `source` to this buffer. Return the number of characters written, which is either `length` or the distance from the current write position to the end of the write buffer, whichever is smaller, and move the write cursor position by this amount. The behaviour is undefined unless `source != 0 || length > 0`.

== Return Value

number of characters successfully written

== Parameters

[cols="1,4"]
|===
| Name| Description
| *source*
| buffer of characters to write
| *length*
| number of characters to write
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#