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

This `struct` provides a namespace for a suite of functions used for acquiring random numbers from the system.

== Synopsis

Declared in `<bdlb_randomdevice.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
struct RandomDevice;
----

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlb/RandomDevice/size_t.adoc[`size_t`] 
| Alias for `bsls::Types::size_type`, used for buffer sizes.
|===


== Static Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlb/RandomDevice/getRandomBytes.adoc[`getRandomBytes`] 
| Read the specified `numBytes` from the system random number generator into the specified `buffer`. Returns 0 on success, non‐zero otherwise. Note that this method may block if called repeatedly or if `numBytes` is high.
| xref:BloombergLP/bdlb/RandomDevice/getRandomBytesNonBlocking.adoc[`getRandomBytesNonBlocking`] 
| Read the specified `numBytes` from the system non‐blocking random number generator into the specified `buffer`. Returns 0 on success, non‐zero otherwise. 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.
|===



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