[#BloombergLP-bdlsb-FixedMemInStreamBuf-xsgetn]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlsb.adoc[bdlsb]::xref:BloombergLP/bdlsb/FixedMemInStreamBuf.adoc[FixedMemInStreamBuf]::xsgetn
:relfileprefix: ../../../
:mrdocs:

Read characters from this stream buffer into a destination buffer.

== Synopsis

Declared in `<bdlsb_fixedmeminstreambuf.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
virtual
std::streamsize
xsgetn(
    char_type* destination,
    std::streamsize length) override;
----

== Description

Read the specified `length` number of characters into the specified `destination`. Return the number of characters successfully read. The behavior is undefined unless `0 <= length`.

== Return Value

number of characters successfully read

== Parameters

[cols="1,4"]
|===
| Name| Description
| *destination*
| buffer to receive the characters read
| *length*
| number of characters to read
|===


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