[#BloombergLP-bdlb-RandomDevice-getRandomBytesNonBlocking]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlb.adoc[bdlb]::xref:BloombergLP/bdlb/RandomDevice.adoc[RandomDevice]::getRandomBytesNonBlocking
:relfileprefix: ../../../
:mrdocs:

Load random bytes from the system non‐blocking random number generator.

== Synopsis

Declared in `<bdlb_randomdevice.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
getRandomBytesNonBlocking(
    unsigned char* buffer,
    xref:BloombergLP/bdlb/RandomDevice/size_t.adoc[size_t] numBytes);
----

== Description

Read the specified `numBytes` from the system non‐blocking random number generator into the specified `buffer`. Note that the cryptographic strength of samples drawn from this pool may or may not be lower than that of those drawn from the blocking pool, and may vary by platform.

== Return Value

0 on success, and a non‐zero value otherwise

== Parameters

[cols="1,4"]
|===
| Name| Description
| *buffer*
| buffer to receive the random bytes
| *numBytes*
| number of bytes to read into `buffer`
|===


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