1 /* GLIB - Library of useful routines for C programming 2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald 3 * 4 * This library is free software; you can redistribute it and/or 5 * modify it under the terms of the GNU Lesser General Public 6 * License as published by the Free Software Foundation; either 7 * version 2 of the License, or (at your option) any later version. 8 * 9 * This library is distributed in the hope that it will be useful, 10 * but WITHOUT ANY WARRANTY; without even the implied warranty of 11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 12 * Lesser General Public License for more details. 13 * 14 * You should have received a copy of the GNU Lesser General Public 15 * License along with this library; if not, write to the 16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330, 17 * Boston, MA 02111-1307, USA. 18 */ 19 20 /* 21 * Modified by the GLib Team and others 1997-2000. See the AUTHORS 22 * file for a list of people on the GLib Team. See the ChangeLog 23 * files for a list of changes. These files are distributed with 24 * GLib at ftp://ftp.gtk.org/pub/gtk/. 25 */ 26 27 #if defined(G_DISABLE_SINGLE_INCLUDES) && !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION) 28 #error "Only <glib.h> can be included directly." 29 #endif 30 31 #ifndef __G_RAND_H__ 32 #define __G_RAND_H__ 33 34 #include <glib/gtypes.h> 35 36 G_BEGIN_DECLS 37 38 typedef struct _GRand GRand; 39 40 /* GRand - a good and fast random number generator: Mersenne Twister 41 * see http://www.math.keio.ac.jp/~matumoto/emt.html for more info. 42 * The range functions return a value in the intervall [begin, end). 43 * int -> [0..2^32-1] 44 * int_range -> [begin..end-1] 45 * double -> [0..1) 46 * double_range -> [begin..end) 47 */ 48 49 GRand* g_rand_new_with_seed (guint32 seed); 50 GRand* g_rand_new_with_seed_array (const guint32 *seed, 51 guint seed_length); 52 GRand* g_rand_new (void); 53 void g_rand_free (GRand *rand_); 54 GRand* g_rand_copy (GRand *rand_); 55 void g_rand_set_seed (GRand *rand_, 56 guint32 seed); 57 void g_rand_set_seed_array (GRand *rand_, 58 const guint32 *seed, 59 guint seed_length); 60 61 #define g_rand_boolean(rand_) ((g_rand_int (rand_) & (1 << 15)) != 0) 62 63 guint32 g_rand_int (GRand *rand_); 64 gint32 g_rand_int_range (GRand *rand_, 65 gint32 begin, 66 gint32 end); 67 gdouble g_rand_double (GRand *rand_); 68 gdouble g_rand_double_range (GRand *rand_, 69 gdouble begin, 70 gdouble end); 71 void g_random_set_seed (guint32 seed); 72 73 #define g_random_boolean() ((g_random_int () & (1 << 15)) != 0) 74 75 guint32 g_random_int (void); 76 gint32 g_random_int_range (gint32 begin, 77 gint32 end); 78 gdouble g_random_double (void); 79 gdouble g_random_double_range (gdouble begin, 80 gdouble end); 81 82 83 G_END_DECLS 84 85 #endif /* __G_RAND_H__ */ 86