[#BloombergLP-bdls-FdStreamBuf_FileHandler-read]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdls.adoc[bdls]::xref:BloombergLP/bdls/FdStreamBuf_FileHandler.adoc[FdStreamBuf&lowbar;FileHandler]::read
:relfileprefix: ../../../
:mrdocs:

Read the specified `numBytes` bytes from the current position of the file descriptor into the specified `buffer`&period; Return the number of characters successfully read&period; The behavior is undefined unless `0 &lt;&equals; numBytes` and `buffer` is at least `numBytes` long&period; Note that on Windows in text mode, &grave;&bsol;r &grave; is read as a single character and stored in the buffer as &grave; &grave;&period;

== Synopsis

Declared in `&lt;bdls&lowbar;fdstreambuf&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
read(
    char* buffer,
    int numBytes);
----


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