diff options
author | Paul Eggert <eggert@cs.ucla.edu> | 2006-08-08 22:22:47 +0000 |
---|---|---|
committer | Paul Eggert <eggert@cs.ucla.edu> | 2006-08-08 22:22:47 +0000 |
commit | 73742c2566e6f8d56b3b132026ad477b9924e774 (patch) | |
tree | 823ee8f3472c0901cdcc6d662a110efc4b7ea1ae /lib/randint.h | |
parent | f2f8ea1001b4e29bba94b47f72d21f758e596288 (diff) | |
download | coreutils-73742c2566e6f8d56b3b132026ad477b9924e774.tar.xz |
New file, introduced for shuf, sort -R, and/or shred.
Diffstat (limited to 'lib/randint.h')
-rw-r--r-- | lib/randint.h | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/lib/randint.h b/lib/randint.h new file mode 100644 index 000000000..4245a6d3f --- /dev/null +++ b/lib/randint.h @@ -0,0 +1,52 @@ +/* Generate random integers. + + Copyright (C) 2006 Free Software Foundation, Inc. + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2, or (at your option) + any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software Foundation, + Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ + +/* Written by Paul Eggert. */ + +#ifndef RANDINT_H + +# define RANDINT_H 1 + +# include <stdint.h> + +# include "randread.h" + +/* An unsigned integer type, used for random integers, and its maximum + value. */ +typedef uintmax_t randint; +# define RANDINT_MAX UINTMAX_MAX + +struct randint_source; + +struct randint_source *randint_new (struct randread_source *); +struct randint_source *randint_all_new (char const *, size_t); +struct randread_source *randint_get_source (struct randint_source const *); +randint randint_genmax (struct randint_source *, randint genmax); + +/* Consume random data from *S to generate a random number in the range + 0 .. CHOICES-1. CHOICES must be nonzero. */ +static inline randint +randint_choose (struct randint_source *s, randint choices) +{ + return randint_genmax (s, choices - 1); +} + +void randint_free (struct randint_source *); +int randint_all_free (struct randint_source *); + +#endif |