[#BloombergLP-bdls-FdStreamBuf_FileHandler-read]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdls.adoc[bdls]::xref:BloombergLP/bdls/FdStreamBuf_FileHandler.adoc[FdStreamBuf_FileHandler]::read
:relfileprefix: ../../../
:mrdocs:

Read the specified `numBytes` bytes from the current position of the file descriptor into the specified `buffer`. Return the number of characters successfully read. The behavior is undefined unless `0 <= numBytes` and `buffer` is at least `numBytes` long. Note that on Windows in text mode, `\r ` is read as a single character and stored in the buffer as ` `.

== Synopsis

Declared in `<bdls_fdstreambuf.h>`

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


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