xref: /PHP-7.4/ext/standard/php_random.h (revision 4a55794b)
1 /*
2    +----------------------------------------------------------------------+
3    | PHP Version 7                                                        |
4    +----------------------------------------------------------------------+
5    | Copyright (c) The PHP Group                                          |
6    +----------------------------------------------------------------------+
7    | This source file is subject to version 3.01 of the PHP license,      |
8    | that is bundled with this package in the file LICENSE, and is        |
9    | available through the world-wide-web at the following url:           |
10    | http://www.php.net/license/3_01.txt                                  |
11    | If you did not receive a copy of the PHP license and are unable to   |
12    | obtain it through the world-wide-web, please send a note to          |
13    | license@php.net so we can mail you a copy immediately.               |
14    +----------------------------------------------------------------------+
15    | Authors: Sammy Kaye Powers <me@sammyk.me>                            |
16    +----------------------------------------------------------------------+
17 */
18 
19 #ifndef PHP_RANDOM_H
20 #define PHP_RANDOM_H
21 
22 BEGIN_EXTERN_C()
23 
24 PHP_FUNCTION(random_bytes);
25 PHP_FUNCTION(random_int);
26 
27 PHP_MINIT_FUNCTION(random);
28 PHP_MSHUTDOWN_FUNCTION(random);
29 
30 typedef struct {
31 	int fd;
32 } php_random_globals;
33 
34 #define php_random_bytes_throw(b, s) php_random_bytes((b), (s), 1)
35 #define php_random_bytes_silent(b, s) php_random_bytes((b), (s), 0)
36 
37 #define php_random_int_throw(min, max, result) \
38 	php_random_int((min), (max), (result), 1)
39 #define php_random_int_silent(min, max, result) \
40 	php_random_int((min), (max), (result), 0)
41 
42 PHPAPI int php_random_bytes(void *bytes, size_t size, zend_bool should_throw);
43 PHPAPI int php_random_int(zend_long min, zend_long max, zend_long *result, zend_bool should_throw);
44 
45 #ifdef ZTS
46 # define RANDOM_G(v) ZEND_TSRMG(random_globals_id, php_random_globals *, v)
47 extern PHPAPI int random_globals_id;
48 #else
49 # define RANDOM_G(v) random_globals.v
50 extern PHPAPI php_random_globals random_globals;
51 #endif
52 
53 END_EXTERN_C()
54 
55 #endif
56