setstate()

Перезагрузить состояние генератора псевдослучайных чисел

Прототип:

#include <stdlib.h>
                                       
char * setstate( const char *state );

Аргументы:

state

Указатель на массив состояний, которые необходимо использовать.

Библиотека:

libc

Описание:

После того, как генератор псевдослучайных чисел было инициализирован, функция setstate() позволяет переключаться между массивами состояний генератора. Массив, определенный параметров state, используется для дальнейшей генерации случайных чисел до тех пор пока не будет вызвана функция initstate() или снова не будет вызвана функция setstate(). Функция setstate() возвращает указатель на массив предыдущего состояния генератора.

Данная функция используется в сочетании со следующими:

initstate()

Инициализировать состояние генератора псевдослучайных чисел.

random()

Сгенерировать псевдослучайное число, используя состояние генератора по умолчанию.

srandom()

Установить начальное значение генератора псевдослучайных чисел.

После инициализации возможно перезапустить массив состояний одним из двух способов:

• Путем вызова функции initstate() с новыми параметрами: начальным значением, массивом состояний и размером массива).

• Путем вызова функции setstate() с заданным состоянием, а затем вызова srandom() с заданным начальным значением. В данном случае преимущество заключается в том, что не требуется сохранять размер массива состояний после его инициализации.

Возвращаемое значение:

Указатель на массив предыдущего состояния генератора, или NULL при возникновении ошибки.

Примеры:

См. initstate()

Классификация:

POSIX 1003.1 X/Open Systems Interfaces Extension

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Нет

Тематические ссылки:

drand48(), initstate(), rand(), random(), srand(), srandom()

Предыдущий раздел: Описание API системной библиотеки