summaryrefslogtreecommitdiff
path: root/src/libmowgli/base/random.h
diff options
context:
space:
mode:
Diffstat (limited to 'src/libmowgli/base/random.h')
-rw-r--r--src/libmowgli/base/random.h45
1 files changed, 45 insertions, 0 deletions
diff --git a/src/libmowgli/base/random.h b/src/libmowgli/base/random.h
new file mode 100644
index 0000000..ea53dd7
--- /dev/null
+++ b/src/libmowgli/base/random.h
@@ -0,0 +1,45 @@
+/*
+ * libmowgli: A collection of useful routines for programming.
+ * random.h: Portable mersinne-twister based psuedo-random number generator.
+ *
+ * Copyright (c) 2007 William Pitcock <nenolod -at- sacredspiral.co.uk>
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice is present in all copies.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef __MOWGLI_RANDOM_H__
+#define __MOWGLI_RANDOM_H__
+
+/* mowgli_random_t contains state data which is private */
+struct mowgli_random_;
+typedef struct mowgli_random_ mowgli_random_t;
+
+/* object class initialization. */
+extern void mowgli_random_bootstrap(void);
+
+/* construction and destruction. */
+extern mowgli_random_t *mowgli_random_create(void);
+extern mowgli_random_t *mowgli_random_create_with_seed(unsigned int seed);
+
+/* reset seed */
+extern void mowgli_random_reseed(mowgli_random_t *self, unsigned int seed);
+
+/* number retrieval */
+extern unsigned int mowgli_random_int(mowgli_random_t *self);
+extern int mowgli_random_int_ranged(mowgli_random_t *self, int begin, int end);
+
+#endif