Requisitos denominados de C++:RandomNumberEngine(desde C++11)

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Requisitos denominados de C++

Básicos ConstruiblePorDefecto ConstruiblePorMovimiento (C++11) ConstruiblePorCopia AsignablePorCopia AsignablePorMovimiento (C++11) Destructible Props. de Tipos TipoEscalar TipoPOD TrivialmenteCopiable (C++11) TipoTrivial (C++11) TipoDeDiseñoEstándar (C++11)   TipoDeTiempoDeVidaImplícito Toda la biblioteca ComprobableBooleano ComparableEnIgualdad ComparableEnMenorQue Intercambiable IntercambiableEnValor (C++11) NullablePointer (C++11) Hash (C++11) Asignador ObjetoFunción Invocable Predicado PredicadoBinario Comparar

Contenedores Contenedor ContenedorReversible ContenedorConscienteDeAsignador ContenedorDeSecuencia ContenedorContiguo (C++17) ContenedorAsociativo ContenedorAsociativoNoOrdenado (C++11)   Elementos de contenedores InsertablePorDefecto (C++11) InsertablePorCopia (C++11) InsertablePorMovimiento (C++11) ConstruiblePorEmplazamiento (C++11) Borrable (C++11) Iteradores IteradorLegado IteradorDeEntradaLegado IteradorDeSalidaLegado IteradorDeAvanceLegado IteradorBidireccionalLegado IteradorDeAccesoAleatorioLegado IteradorContiguoLegado (C++17) IteradorConstexpr (C++20) E/S de flujos FunciónDeEntradaConFormato FunciónDeEntradaSinFormato FunciónDeSalidaConFormato FunciónDeSalidaSinFormato Formateadores FormateadorBásico (C++20) Formateador (C++20)

Números aleatorios SeedSequence (C++11) MotorDeNúmerosAleatorios (C++11) DistribuciónDeNúmerosAleatorios (C++11) GeneradorDeBitsAleatorioUniforme (C++11) AdaptadorDeMotorDeNúmerosAleatorios (C++11) Concurrencia BloqueableBásico (C++11) Bloqueable (C++11) BloqueableTemporizado (C++11) BloqueableCompartido (C++14) BloqueableTemporizadoCompartido (C++14) Mutex (C++11) MutexTemporizado (C++11) MutexCompartido (C++17) MutexTemporizadoCompartido (C++14) Rangos ObjetoAdaptadorDeRango (C++20) ObjetoCierreAdaptadorDeRango (C++20) Vista multidimensional LayoutMapping (C++23) LayoutMappingPolicy (C++23) AccessorPolicy (C++23) Otros RasgosDeCarácter RasgosDeExpresiónRegular (C++11)   TipoMáscaraDeBits TipoLiteral (C++11) TipoNumérico RasgoDeTipoUnario (C++11) RasgoDeTipoBinario (C++11) RasgoDeTransformación (C++11) Reloj (C++11) RelojTrivial (C++11)

 

Un motor de números aleatorios es un objeto función que devuelve valores enteros sin signo de modo que cada valor del rango de posibles resultados tiene la misma probabilidad (idealmente).

Cualquier motor de números aleatorios es un GeneradorDeBitsAleatorioUniforme, y, por lo tanto, puede conectarse a cualquier distribución de números aleatorios para obtener un número aleatorio (formalmente, una variable aleatoria).

Requisitos

Un tipo satisface MotorDeNúmerosAleatorios si satisface GeneradorDeBitsAleatorioUniforme, y, dados los siguientes tipos y valores, se satisfacen los requisitos de semántica y complejidad es la siguiente tabla:

Tipo	Definición
E	Un tipo MotorDeNúmerosAleatorios.
T	E::result_type.
Valor	Definición
e	Un valor de tipo E.
v	Un l-valor de tipo E.
x, y	Valores de tipo (que pueden estar calificados const) E.
s	Un valor de tipo T.
q	Un l-valor SeedSequence.
z	Un valor de tipo unsignedlonglong.
os	Un l-valor cuyo tipo es una especialización de std::basic_ostream.
is	Un l-valor cuyo tipo es una especialización de std::basic_istream.
n	El tamaño del estado de E.
TA	El algoritmo de transición de E.
GA	El algoritmo de generación de E.

Expresión	Tipo devuelto	Semántica	Complejidad
E()	N/A	Crea un motor con el mismo estado inicial que todos los demás motores construidos por defecto del tipo E.	\(\scriptsize O(n)\)O(n)
E(x)		Crea un motor que se compara igual a x.	\(\scriptsize O(n)\)O(n)
E(s)		Crea un motor cuyo estado inicial se determina por s.	\(\scriptsize O(n)\)O(n)
E(q)		Crea un motor cuyo estado inicial está determinado por una única llamada a q.generate.	La misma que la complejidad de q.generate llamada en una secuencia cuya longitud es n.
e.seed()	void	Poscondición: e == E().	Igual que E().
e.seed(s)	void	Poscondición: e == E(s).	Igual que E(s).
e.seed(q)	void	Poscondición: e == E(q).	Igual que E(q).
e()	T	Avanza el estado de e desde e i a e i+1 (por ejemplo TA(e i)) y devuelve GA(e i).	Amortizado constante.
e.discard(z)	void	Avanza el estado de e desde e i a e i+z por cualquier medio equivalente a z llamadas consecutivas a e().	No es peor que la complejidad de z llamadas consecutivas a e().
x == y	bool	Para todos lo enteros positivos i, si las i-ésimas llamadas consecutivas a x() e y() devuelven el mismo valor, devuelve true. De lo contrario, devuelve false.	\(\scriptsize O(n)\)O(n)
x != y	bool	!(x == y)	\(\scriptsize O(n)\)O(n)
os << x	decltype(os)&	Con los indicadores de formato establecidos en std::ios_base::dec|std::ios_base::left y el carácter de relleno establecido en el carácter espacio, escribe en os la representación textual del estado actual de x. Poscondición: los indicadores de formato de os y el carácter de relleno son los mismos de antes.	\(\scriptsize O(n)\)O(n)
is >> v	decltype(is)&	Con los indicadores de formato establecidos en std::ios_base::dec, lee de is la representación textual del estado actual de v. Si se encuentra una entrada errónea, asegura que el estado de v no cambia por la operación y llama a is.setstate(std::ios_base::failbit) (que puede lanzar la excepción std::ios_base::failure). Precondición: is proporciona una representación textual que se escribió previamente usando un flujo de salida pr que satisface todas las condiciones siguientes: is.getloc()== pr.getloc() es true. std::is_same<decltype(is)::char_type,              decltype(pr)::char_type>::value es true. std::is_same<decltype(is)::traits_type,              decltype(pr)::traits_type>::value es true. Poscondición: los indicadores de formato de is son los mismos que antes.	\(\scriptsize O(n)\)O(n)

Biblioteca estándar

Las siguientes funciones de la biblioteca estándar satifacen MotorDeNúmerosAleatorios:

linear_congruential_engine (C++11)	Implementa un algoritmo generador lineal congruencial. (plantilla de clase)
mersenne_twister_engine (C++11)	Implementa el algoritmo Mersenne twister (plantilla de clase)
subtract_with_carry_engine (C++11)	Implementa un algoritmo de resta con acarreo (Fibonacci con retraso). (plantilla de clase)
philox_engine (C++26)	Un generador paralelizable basado en recuentos. (plantilla de clase)
discard_block_engine (C++11)	Descarta alguna salida de un motor de números aleatorios. (plantilla de clase)
independent_bits_engine (C++11)	Empaqueta la salida de un motor de números aleatorios en bloques de un número específico de bits. (plantilla de clase)
shuffle_order_engine (C++11)	Entrega la salida de un motor de número aleatorios en un orden diferente. (plantilla de clase)

Las siguientes funciones de la biblioteca estándar satisfacen GeneradorDeBitsAleatorioUniforme pero no MotorDeNúmerosAleatorios:

random_device (C++11)

Generador de números aleatorios no determinista usando como fuente entropía hardware. (clase)