72 lines
4.0 KiB
C++
72 lines
4.0 KiB
C++
/**************************************************************************************/
|
|
/* */
|
|
/* Visualization Library */
|
|
/* http://visualizationlibrary.org */
|
|
/* */
|
|
/* Copyright (c) 2005-2020, Michele Bosi */
|
|
/* All rights reserved. */
|
|
/* */
|
|
/* Redistribution and use in source and binary forms, with or without modification, */
|
|
/* are permitted provided that the following conditions are met: */
|
|
/* */
|
|
/* - Redistributions of source code must retain the above copyright notice, this */
|
|
/* list of conditions and the following disclaimer. */
|
|
/* */
|
|
/* - Redistributions in binary form must reproduce the above copyright notice, this */
|
|
/* list of conditions and the following disclaimer in the documentation and/or */
|
|
/* other materials provided with the distribution. */
|
|
/* */
|
|
/* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND */
|
|
/* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED */
|
|
/* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE */
|
|
/* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR */
|
|
/* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES */
|
|
/* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; */
|
|
/* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON */
|
|
/* ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT */
|
|
/* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS */
|
|
/* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */
|
|
/* */
|
|
/**************************************************************************************/
|
|
|
|
#ifndef Random_INCLUDE_ONCE
|
|
#define Random_INCLUDE_ONCE
|
|
|
|
#include <vlCore/Object.hpp>
|
|
|
|
namespace vl
|
|
{
|
|
//! Cryptographic random number generator.
|
|
//! For non-ryptographic fast and high quality random number generation use vl::MersenneTwister.
|
|
class VLCORE_EXPORT Random: public Object
|
|
{
|
|
VL_INSTRUMENT_CLASS(vl::Random, Object)
|
|
|
|
public:
|
|
//! Constructor.
|
|
Random();
|
|
|
|
//! Destructor.
|
|
virtual ~Random();
|
|
|
|
//! Fills the specified buffer with random data generated using the best quality random number generation facilities available.
|
|
//! Under Windows (including MinGW) \p CryptGenRandom is used, while under Unix-like operating systems \p /dev/urandom is used.
|
|
//! If no special random number generation facility is detected the function falls back to use a MersenneTwister.
|
|
//! \return This method returns \p false if the function had to fallback to MersenneTwister otherwise returns \p true.
|
|
virtual bool fillRandom(void* ptr, size_t bytes) const;
|
|
|
|
//! Fills the specified buffer with random data generated using a defMersienneTwister().
|
|
//! MersienneTwister produces high quality random number and can be much faster than fillRandom().
|
|
void fillRandomMersenneTwister(void* ptr, size_t bytes) const;
|
|
|
|
private:
|
|
#if defined(_MSC_VER) || defined(__MINGW32__)
|
|
void* hCryptProv;
|
|
#elif defined(__GNUG__) && !defined(__MINGW32__)
|
|
FILE* mDefURandom;
|
|
#endif
|
|
};
|
|
}
|
|
|
|
#endif
|