[#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&period;

== Synopsis

Declared in `&lt;bdlsb&lowbar;overflowmemoutput&period;h&gt;`

[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&period; 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&period; The behaviour is undefined unless `source !&equals; 0 &verbar;&verbar; length &gt; 0`&period;

== 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]#
