ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/include/util.h
(Generate patch)

Comparing deliantra/server/include/util.h (file contents):
Revision 1.91 by root, Thu Oct 15 21:09:32 2009 UTC vs.
Revision 1.116 by root, Sat Dec 31 06:18:01 2011 UTC

1/* 1/*
2 * This file is part of Deliantra, the Roguelike Realtime MMORPG. 2 * This file is part of Deliantra, the Roguelike Realtime MMORPG.
3 * 3 *
4 * Copyright (©) 2005,2006,2007,2008 Marc Alexander Lehmann / Robin Redeker / the Deliantra team 4 * Copyright (©) 2005,2006,2007,2008,2009,2010,2011 Marc Alexander Lehmann / Robin Redeker / the Deliantra team
5 * 5 *
6 * Deliantra is free software: you can redistribute it and/or modify it under 6 * Deliantra is free software: you can redistribute it and/or modify it under
7 * the terms of the Affero GNU General Public License as published by the 7 * the terms of the Affero GNU General Public License as published by the
8 * Free Software Foundation, either version 3 of the License, or (at your 8 * Free Software Foundation, either version 3 of the License, or (at your
9 * option) any later version. 9 * option) any later version.
21 */ 21 */
22 22
23#ifndef UTIL_H__ 23#ifndef UTIL_H__
24#define UTIL_H__ 24#define UTIL_H__
25 25
26#include <compiler.h>
27
26#define DEBUG_POISON 0x00 // poison memory before freeing it if != 0 28#define DEBUG_POISON 0x00 // poison memory before freeing it if != 0
27#define DEBUG_SALLOC 0 // add a debug wrapper around all sallocs 29#define DEBUG_SALLOC 0 // add a debug wrapper around all sallocs
28#define PREFER_MALLOC 0 // use malloc and not the slice allocator 30#define PREFER_MALLOC 0 // use malloc and not the slice allocator
29
30#if __GNUC__ >= 3
31# define is_constant(c) __builtin_constant_p (c)
32# define expect(expr,value) __builtin_expect ((expr),(value))
33# define prefetch(addr,rw,locality) __builtin_prefetch (addr, rw, locality)
34# define noinline __attribute__((__noinline__))
35#else
36# define is_constant(c) 0
37# define expect(expr,value) (expr)
38# define prefetch(addr,rw,locality)
39# define noinline
40#endif
41
42#if __GNUC__ < 4 || (__GNUC__ == 4 || __GNUC_MINOR__ < 4)
43# define decltype(x) typeof(x)
44#endif
45
46// put into ifs if you are very sure that the expression
47// is mostly true or mosty false. note that these return
48// booleans, not the expression.
49#define expect_false(expr) expect ((expr) ? 1 : 0, 0)
50#define expect_true(expr) expect ((expr) ? 1 : 0, 1)
51 31
52#include <pthread.h> 32#include <pthread.h>
53 33
54#include <cstddef> 34#include <cstddef>
55#include <cmath> 35#include <cmath>
75#endif 55#endif
76 56
77// use C0X decltype for auto declarations until ISO C++ sanctifies them (if ever) 57// use C0X decltype for auto declarations until ISO C++ sanctifies them (if ever)
78#define auto(var,expr) decltype(expr) var = (expr) 58#define auto(var,expr) decltype(expr) var = (expr)
79 59
60#if cplusplus_does_not_suck
61// does not work for local types (http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2657.htm)
62template<typename T, int N>
63static inline int array_length (const T (&arr)[N])
64{
65 return N;
66}
67#else
68#define array_length(name) (sizeof (name) / sizeof (name [0]))
69#endif
70
80// very ugly macro that basically declares and initialises a variable 71// very ugly macro that basically declares and initialises a variable
81// that is in scope for the next statement only 72// that is in scope for the next statement only
82// works only for stuff that can be assigned 0 and converts to false 73// works only for stuff that can be assigned 0 and converts to false
83// (note: works great for pointers) 74// (note: works great for pointers)
84// most ugly macro I ever wrote 75// most ugly macro I ever wrote
95void cleanup (const char *cause, bool make_core = false); 86void cleanup (const char *cause, bool make_core = false);
96void fork_abort (const char *msg); 87void fork_abort (const char *msg);
97 88
98// rationale for using (U) not (T) is to reduce signed/unsigned issues, 89// rationale for using (U) not (T) is to reduce signed/unsigned issues,
99// as a is often a constant while b is the variable. it is still a bug, though. 90// as a is often a constant while b is the variable. it is still a bug, though.
100template<typename T, typename U> static inline T min (T a, U b) { return (U)a < b ? (U)a : b; } 91template<typename T, typename U> static inline T min (T a, U b) { return a < (T)b ? a : (T)b; }
101template<typename T, typename U> static inline T max (T a, U b) { return (U)a > b ? (U)a : b; } 92template<typename T, typename U> static inline T max (T a, U b) { return a > (T)b ? a : (T)b; }
102template<typename T, typename U, typename V> static inline T clamp (T v, U a, V b) { return v < (T)a ? (T)a : v >(T)b ? (T)b : v; } 93template<typename T, typename U, typename V> static inline T clamp (T v, U a, V b) { return v < (T)a ? (T)a : v >(T)b ? (T)b : v; }
103 94
104template<typename T, typename U> static inline void min_it (T &v, U m) { v = min (v, (T)m); } 95template<typename T, typename U> static inline void min_it (T &v, U m) { v = min (v, (T)m); }
105template<typename T, typename U> static inline void max_it (T &v, U m) { v = max (v, (T)m); } 96template<typename T, typename U> static inline void max_it (T &v, U m) { v = max (v, (T)m); }
106template<typename T, typename U, typename V> static inline void clamp_it (T &v, U a, V b) { v = clamp (v, (T)a, (T)b); } 97template<typename T, typename U, typename V> static inline void clamp_it (T &v, U a, V b) { v = clamp (v, (T)a, (T)b); }
113// sign returns -1 or +1 104// sign returns -1 or +1
114template<typename T> 105template<typename T>
115static inline T sign (T v) { return v < 0 ? -1 : +1; } 106static inline T sign (T v) { return v < 0 ? -1 : +1; }
116// relies on 2c representation 107// relies on 2c representation
117template<> 108template<>
118inline sint8 sign (sint8 v) { return 1 - (sint8 (uint8 (v) >> 7) * 2); } 109inline sint8 sign (sint8 v) { return 1 - (sint8 (uint8 (v) >> 7) * 2); }
110template<>
111inline sint16 sign (sint16 v) { return 1 - (sint16 (uint16 (v) >> 15) * 2); }
112template<>
113inline sint32 sign (sint32 v) { return 1 - (sint32 (uint32 (v) >> 31) * 2); }
119 114
120// sign0 returns -1, 0 or +1 115// sign0 returns -1, 0 or +1
121template<typename T> 116template<typename T>
122static inline T sign0 (T v) { return v ? sign (v) : 0; } 117static inline T sign0 (T v) { return v ? sign (v) : 0; }
118
119//clashes with C++0x
120template<typename T, typename U>
121static inline T copysign (T a, U b) { return a > 0 ? b : -b; }
123 122
124// div* only work correctly for div > 0 123// div* only work correctly for div > 0
125// div, with correct rounding (< 0.5 downwards, >=0.5 upwards) 124// div, with correct rounding (< 0.5 downwards, >=0.5 upwards)
126template<typename T> static inline T div (T val, T div) 125template<typename T> static inline T div (T val, T div)
127{ 126{
128 return expect_false (val < 0) ? - ((-val + (div - 1) / 2) / div) : (val + div / 2) / div; 127 return expect_false (val < 0) ? - ((-val + (div - 1) / 2) / div) : (val + div / 2) / div;
129} 128}
129
130template<> inline float div (float val, float div) { return val / div; }
131template<> inline double div (double val, double div) { return val / div; }
132
130// div, round-up 133// div, round-up
131template<typename T> static inline T div_ru (T val, T div) 134template<typename T> static inline T div_ru (T val, T div)
132{ 135{
133 return expect_false (val < 0) ? - ((-val ) / div) : (val + div - 1) / div; 136 return expect_false (val < 0) ? - ((-val ) / div) : (val + div - 1) / div;
134} 137}
206 int32_t d = b - a; 209 int32_t d = b - a;
207 d &= d >> 31; 210 d &= d >> 31;
208 return b - d; 211 return b - d;
209} 212}
210 213
211// this is much faster than crossfires original algorithm 214// this is much faster than crossfire's original algorithm
212// on modern cpus 215// on modern cpus
213inline int 216inline int
214isqrt (int n) 217isqrt (int n)
215{ 218{
216 return (int)sqrtf ((float)n); 219 return (int)sqrtf ((float)n);
220}
221
222// this is kind of like the ^^ operator, if it would exist, without sequence point.
223// more handy than it looks like, due to the implicit !! done on its arguments
224inline bool
225logical_xor (bool a, bool b)
226{
227 return a != b;
228}
229
230inline bool
231logical_implies (bool a, bool b)
232{
233 return a <= b;
217} 234}
218 235
219// this is only twice as fast as naive sqrtf (dx*dy+dy*dy) 236// this is only twice as fast as naive sqrtf (dx*dy+dy*dy)
220#if 0 237#if 0
221// and has a max. error of 6 in the range -100..+100. 238// and has a max. error of 6 in the range -100..+100.
235#else 252#else
236 return dx_ + dy_ - min (dx_, dy_) * 5 / 8; 253 return dx_ + dy_ - min (dx_, dy_) * 5 / 8;
237#endif 254#endif
238} 255}
239 256
257// can be substantially faster than floor, if your value range allows for it
258template<typename T>
259inline T
260fastfloor (T x)
261{
262 return std::floor (x);
263}
264
265inline float
266fastfloor (float x)
267{
268 return sint32(x) - (x < 0);
269}
270
271inline double
272fastfloor (double x)
273{
274 return sint64(x) - (x < 0);
275}
276
240/* 277/*
241 * absdir(int): Returns a number between 1 and 8, which represent 278 * absdir(int): Returns a number between 1 and 8, which represent
242 * the "absolute" direction of a number (it actually takes care of 279 * the "absolute" direction of a number (it actually takes care of
243 * "overflow" in previous calculations of a direction). 280 * "overflow" in previous calculations of a direction).
244 */ 281 */
246absdir (int d) 283absdir (int d)
247{ 284{
248 return ((d - 1) & 7) + 1; 285 return ((d - 1) & 7) + 1;
249} 286}
250 287
288// avoid ctz name because netbsd or freebsd spams it's namespace with it
289#if GCC_VERSION(3,4)
290static inline int least_significant_bit (uint32_t x)
291{
292 return __builtin_ctz (x);
293}
294#else
295int least_significant_bit (uint32_t x);
296#endif
297
298#define for_all_bits_sparse_32(mask, idxvar) \
299 for (uint32_t idxvar, mask_ = mask; \
300 mask_ && ((idxvar = least_significant_bit (mask_)), mask_ &= ~(1 << idxvar), 1);)
301
251extern ssize_t slice_alloc; // statistics 302extern ssize_t slice_alloc; // statistics
252 303
253void *salloc_ (int n) throw (std::bad_alloc); 304void *salloc_ (int n) throw (std::bad_alloc);
254void *salloc_ (int n, void *src) throw (std::bad_alloc); 305void *salloc_ (int n, void *src) throw (std::bad_alloc);
255 306
399 { 450 {
400 p->~Tp (); 451 p->~Tp ();
401 } 452 }
402}; 453};
403 454
404// P. L'Ecuyer, “Maximally Equidistributed Combined Tausworthe Generators”, Mathematics of Computation, 65, 213 (1996), 203–213.
405// http://www.iro.umontreal.ca/~lecuyer/myftp/papers/tausme.ps
406// http://www.iro.umontreal.ca/~lecuyer/myftp/papers/tausme2.ps
407struct tausworthe_random_generator
408{
409 uint32_t state [4];
410
411 void operator =(const tausworthe_random_generator &src)
412 {
413 state [0] = src.state [0];
414 state [1] = src.state [1];
415 state [2] = src.state [2];
416 state [3] = src.state [3];
417 }
418
419 void seed (uint32_t seed);
420 uint32_t next ();
421};
422
423// Xorshift RNGs, George Marsaglia
424// http://www.jstatsoft.org/v08/i14/paper
425// this one is about 40% faster than the tausworthe one above (i.e. not much),
426// despite the inlining, and has the issue of only creating 2**32-1 numbers.
427// see also http://www.iro.umontreal.ca/~lecuyer/myftp/papers/xorshift.pdf
428struct xorshift_random_generator
429{
430 uint32_t x, y;
431
432 void operator =(const xorshift_random_generator &src)
433 {
434 x = src.x;
435 y = src.y;
436 }
437
438 void seed (uint32_t seed)
439 {
440 x = seed;
441 y = seed * 69069U;
442 }
443
444 uint32_t next ()
445 {
446 uint32_t t = x ^ (x << 10);
447 x = y;
448 y = y ^ (y >> 13) ^ t ^ (t >> 10);
449 return y;
450 }
451};
452
453template<class generator>
454struct random_number_generator : generator
455{
456 // uniform distribution, 0 .. max (0, num - 1)
457 uint32_t operator ()(uint32_t num)
458 {
459 return !is_constant (num) ? get_range (num) // non-constant
460 : num & (num - 1) ? (this->next () * (uint64_t)num) >> 32U // constant, non-power-of-two
461 : this->next () & (num - 1); // constant, power-of-two
462 }
463
464 // return a number within (min .. max)
465 int operator () (int r_min, int r_max)
466 {
467 return is_constant (r_min) && is_constant (r_max) && r_min <= r_max
468 ? r_min + operator ()(r_max - r_min + 1)
469 : get_range (r_min, r_max);
470 }
471
472 double operator ()()
473 {
474 return this->next () / (double)0xFFFFFFFFU;
475 }
476
477protected:
478 uint32_t get_range (uint32_t r_max);
479 int get_range (int r_min, int r_max);
480};
481
482typedef random_number_generator<tausworthe_random_generator> rand_gen;
483
484extern rand_gen rndm, rmg_rndm;
485
486INTERFACE_CLASS (attachable) 455INTERFACE_CLASS (attachable)
487struct refcnt_base 456struct refcnt_base
488{ 457{
489 typedef int refcnt_t; 458 typedef int refcnt_t;
490 mutable refcnt_t ACC (RW, refcnt); 459 mutable refcnt_t ACC (RW, refcnt);
551typedef refptr<maptile> maptile_ptr; 520typedef refptr<maptile> maptile_ptr;
552typedef refptr<object> object_ptr; 521typedef refptr<object> object_ptr;
553typedef refptr<archetype> arch_ptr; 522typedef refptr<archetype> arch_ptr;
554typedef refptr<client> client_ptr; 523typedef refptr<client> client_ptr;
555typedef refptr<player> player_ptr; 524typedef refptr<player> player_ptr;
525typedef refptr<region> region_ptr;
526
527#define STRHSH_NULL 2166136261
528
529static inline uint32_t
530strhsh (const char *s)
531{
532 // use FNV-1a hash (http://isthe.com/chongo/tech/comp/fnv/)
533 // it is about twice as fast as the one-at-a-time one,
534 // with good distribution.
535 // FNV-1a is faster on many cpus because the multiplication
536 // runs concurrently with the looping logic.
537 // we modify the hash a bit to improve its distribution
538 uint32_t hash = STRHSH_NULL;
539
540 while (*s)
541 hash = (hash ^ *s++) * 16777619U;
542
543 return hash ^ (hash >> 16);
544}
545
546static inline uint32_t
547memhsh (const char *s, size_t len)
548{
549 uint32_t hash = STRHSH_NULL;
550
551 while (len--)
552 hash = (hash ^ *s++) * 16777619U;
553
554 return hash;
555}
556 556
557struct str_hash 557struct str_hash
558{ 558{
559 std::size_t operator ()(const char *s) const 559 std::size_t operator ()(const char *s) const
560 { 560 {
561#if 0
562 uint32_t hash = 0;
563
564 /* use the one-at-a-time hash function, which supposedly is
565 * better than the djb2-like one used by perl5.005, but
566 * certainly is better then the bug used here before.
567 * see http://burtleburtle.net/bob/hash/doobs.html
568 */
569 while (*s)
570 {
571 hash += *s++;
572 hash += hash << 10;
573 hash ^= hash >> 6;
574 }
575
576 hash += hash << 3;
577 hash ^= hash >> 11;
578 hash += hash << 15;
579#else
580 // use FNV-1a hash (http://isthe.com/chongo/tech/comp/fnv/)
581 // it is about twice as fast as the one-at-a-time one,
582 // with good distribution.
583 // FNV-1a is faster on many cpus because the multiplication
584 // runs concurrent with the looping logic.
585 uint32_t hash = 2166136261;
586
587 while (*s)
588 hash = (hash ^ *s++) * 16777619;
589#endif
590
591 return hash; 561 return strhsh (s);
562 }
563
564 std::size_t operator ()(const shstr &s) const
565 {
566 return strhsh (s);
592 } 567 }
593}; 568};
594 569
595struct str_equal 570struct str_equal
596{ 571{
688 { 663 {
689 erase (&obj); 664 erase (&obj);
690 } 665 }
691}; 666};
692 667
668/////////////////////////////////////////////////////////////////////////////
669
670// something like a vector or stack, but without
671// out of bounds checking
672template<typename T>
673struct fixed_stack
674{
675 T *data;
676 int size;
677 int max;
678
679 fixed_stack ()
680 : size (0), data (0)
681 {
682 }
683
684 fixed_stack (int max)
685 : size (0), max (max)
686 {
687 data = salloc<T> (max);
688 }
689
690 void reset (int new_max)
691 {
692 sfree (data, max);
693 size = 0;
694 max = new_max;
695 data = salloc<T> (max);
696 }
697
698 void free ()
699 {
700 sfree (data, max);
701 data = 0;
702 }
703
704 ~fixed_stack ()
705 {
706 sfree (data, max);
707 }
708
709 T &operator[](int idx)
710 {
711 return data [idx];
712 }
713
714 void push (T v)
715 {
716 data [size++] = v;
717 }
718
719 T &pop ()
720 {
721 return data [--size];
722 }
723
724 T remove (int idx)
725 {
726 T v = data [idx];
727
728 data [idx] = data [--size];
729
730 return v;
731 }
732};
733
734/////////////////////////////////////////////////////////////////////////////
735
693// basically does what strncpy should do, but appends "..." to strings exceeding length 736// basically does what strncpy should do, but appends "..." to strings exceeding length
694// returns the number of bytes actually used (including \0) 737// returns the number of bytes actually used (including \0)
695int assign (char *dst, const char *src, int maxsize); 738int assign (char *dst, const char *src, int maxsize);
696 739
697// type-safe version of assign 740// type-safe version of assign
708 751
709int similar_direction (int a, int b); 752int similar_direction (int a, int b);
710 753
711// like v?sprintf, but returns a "static" buffer 754// like v?sprintf, but returns a "static" buffer
712char *vformat (const char *format, va_list ap); 755char *vformat (const char *format, va_list ap);
713char *format (const char *format, ...); 756char *format (const char *format, ...) attribute ((format (printf, 1, 2)));
714 757
715// safety-check player input which will become object->msg 758// safety-check player input which will become object->msg
716bool msg_is_safe (const char *msg); 759bool msg_is_safe (const char *msg);
717 760
718///////////////////////////////////////////////////////////////////////////// 761/////////////////////////////////////////////////////////////////////////////

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines