Поделиться через


rand_s

Возвращает псевдослучайное число. Это версия rand с усовершенствованиями безопасности, как описано в Функции безопасности в CRT.

errno_t rand_s(   unsigned int* randomValue);

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

Ноль в случае успешного выполнения, в противном случае — код ошибки. Если параметр randomValue является нулевым указателем, функция вызывает обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если выполнение разрешено для продолжить, функция возвращает EINVAL и задает errno в EINVAL. Если функция завершается с ошибкой по какой-либо другой причине, *randomValue присваивается значение 0.

Заметки

Функция rand_s записывает псевдослучайное целое число в диапазоне от 0 до UINT_MAX по входному указателю. Функция rand_s используется операционной системой для создания криптографически безопасных случайных чисел. В ней не используется начальное значение, созданное функцией srand, и она не влияет на последовательность случайных чисел, используемую rand.

Функция rand_s требует, чтобы константа _CRT_RAND_S определена до включения функции, как показано в следующем примере:

#define _CRT_RAND_S
#include <stdlib.h>

rand_s зависит от API RtlGenRandom, который доступен только в Windows XP или более поздних версиях.

Требования

Подпрограмма

Обязательный заголовок

rand_s

<stdlib.h>

Для получения дополнительной информации см. Совместимость.

Пример

// crt_rand_s.c
// This program illustrates how to generate random
// integer or floating point numbers in a specified range.

// Remembering to define _CRT_RAND_S prior
// to inclusion statement.
#define _CRT_RAND_S

#include <stdlib.h>
#include <stdio.h>
#include <limits.h>

int main( void )
{
    int             i;
    unsigned int    number;
    double          max = 100.0;
    errno_t         err;

    // Display 10 random integers in the range [ 1,10 ].
    for( i = 0; i < 10;i++ )
    {
        err = rand_s( &number );
        if (err != 0)
        {
            printf_s("The rand_s function failed!\n");
        }
        printf_s( "  %u\n", (unsigned int) ((double)number /
                       ((double) UINT_MAX + 1 ) * 10.0) + 1);
    }

    printf_s("\n");

    // Display 10 random doubles in [0, max).
    for (i = 0; i < 10;i++ )
    {
        err = rand_s( &number );
        if (err != 0)
        {
            printf_s("The rand_s function failed!\n");
        }
        printf_s( "  %g\n", (double) number / 
                          ((double) UINT_MAX + 1) * max );
    }
}

Пример результатов выполнения

  10
  4
  5
  2
  8
  2
  5
  6
  1
  1

  32.6617
  29.4471
  11.5413
  6.41924
  20.711
  60.2878
  61.0094
  20.1222
  80.9192
  65.0712

Эквивалент в .NET Framework

System::Random Class

См. также

Ссылки

Поддержка чисел с плавающей запятой

srand