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.61 by root, Fri Jan 25 18:09:23 2008 UTC vs.
Revision 1.100 by root, Thu Apr 22 13:01:58 2010 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 Marc Alexander Lehmann / Robin Redeker / the Deliantra team 4 * Copyright (©) 2005,2006,2007,2008,2009,2010 Marc Alexander Lehmann / Robin Redeker / the Deliantra team
5 * 5 *
6 * Deliantra is free software: you can redistribute it and/or modify 6 * Deliantra is free software: you can redistribute it and/or modify it under
7 * it under the terms of the GNU General Public License as published by 7 * the terms of the Affero GNU General Public License as published by the
8 * the Free Software Foundation, either version 3 of the License, or 8 * Free Software Foundation, either version 3 of the License, or (at your
9 * (at your option) any later version. 9 * option) any later version.
10 * 10 *
11 * This program is distributed in the hope that it will be useful, 11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details. 14 * GNU General Public License for more details.
15 * 15 *
16 * You should have received a copy of the GNU General Public License 16 * You should have received a copy of the Affero GNU General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>. 17 * and the GNU General Public License along with this program. If not, see
18 * <http://www.gnu.org/licenses/>.
18 * 19 *
19 * The authors can be reached via e-mail to <support@deliantra.net> 20 * The authors can be reached via e-mail to <support@deliantra.net>
20 */ 21 */
21 22
22#ifndef UTIL_H__ 23#ifndef UTIL_H__
23#define UTIL_H__ 24#define UTIL_H__
24 25
25//#define PREFER_MALLOC 26#include <compiler.h>
26//#define DEBUG_SALLOC
27 27
28#if __GNUC__ >= 3 28#define DEBUG_POISON 0x00 // poison memory before freeing it if != 0
29# define is_constant(c) __builtin_constant_p (c) 29#define DEBUG_SALLOC 0 // add a debug wrapper around all sallocs
30# define expect(expr,value) __builtin_expect ((expr),(value)) 30#define PREFER_MALLOC 0 // use malloc and not the slice allocator
31# define prefetch(addr,rw,locality) __builtin_prefetch (addr, rw, locality)
32#else
33# define is_constant(c) 0
34# define expect(expr,value) (expr)
35# define prefetch(addr,rw,locality)
36#endif
37 31
38#if __GNUC__ < 4 || (__GNUC__ == 4 || __GNUC_MINOR__ < 4) 32#include <pthread.h>
39# define decltype(x) typeof(x)
40#endif
41
42// put into ifs if you are very sure that the expression
43// is mostly true or mosty false. note that these return
44// booleans, not the expression.
45#define expect_false(expr) expect ((expr) != 0, 0)
46#define expect_true(expr) expect ((expr) != 0, 1)
47 33
48#include <cstddef> 34#include <cstddef>
49#include <cmath> 35#include <cmath>
50#include <new> 36#include <new>
51#include <vector> 37#include <vector>
53#include <glib.h> 39#include <glib.h>
54 40
55#include <shstr.h> 41#include <shstr.h>
56#include <traits.h> 42#include <traits.h>
57 43
58#ifdef DEBUG_SALLOC 44#if DEBUG_SALLOC
59# define g_slice_alloc0(s) debug_slice_alloc0(s) 45# define g_slice_alloc0(s) debug_slice_alloc0(s)
60# define g_slice_alloc(s) debug_slice_alloc(s) 46# define g_slice_alloc(s) debug_slice_alloc(s)
61# define g_slice_free1(s,p) debug_slice_free1(s,p) 47# define g_slice_free1(s,p) debug_slice_free1(s,p)
62void *g_slice_alloc (unsigned long size); 48void *g_slice_alloc (unsigned long size);
63void *g_slice_alloc0 (unsigned long size); 49void *g_slice_alloc0 (unsigned long size);
64void g_slice_free1 (unsigned long size, void *ptr); 50void g_slice_free1 (unsigned long size, void *ptr);
51#elif PREFER_MALLOC
52# define g_slice_alloc0(s) calloc (1, (s))
53# define g_slice_alloc(s) malloc ((s))
54# define g_slice_free1(s,p) free ((p))
65#endif 55#endif
66 56
67// 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)
68#define auto(var,expr) decltype(expr) var = (expr) 58#define auto(var,expr) decltype(expr) var = (expr)
69 59
70// very ugly macro that basicaly declares and initialises a variable 60// very ugly macro that basically declares and initialises a variable
71// that is in scope for the next statement only 61// that is in scope for the next statement only
72// works only for stuff that can be assigned 0 and converts to false 62// works only for stuff that can be assigned 0 and converts to false
73// (note: works great for pointers) 63// (note: works great for pointers)
74// most ugly macro I ever wrote 64// most ugly macro I ever wrote
75#define statementvar(type, name, value) if (type name = 0) { } else if (((name) = (value)), 1) 65#define statementvar(type, name, value) if (type name = 0) { } else if (((name) = (value)), 1)
80 70
81// in range excluding end 71// in range excluding end
82#define IN_RANGE_EXC(val,beg,end) \ 72#define IN_RANGE_EXC(val,beg,end) \
83 ((unsigned int)(val) - (unsigned int)(beg) < (unsigned int)(end) - (unsigned int)(beg)) 73 ((unsigned int)(val) - (unsigned int)(beg) < (unsigned int)(end) - (unsigned int)(beg))
84 74
75void cleanup (const char *cause, bool make_core = false);
85void fork_abort (const char *msg); 76void fork_abort (const char *msg);
86 77
87// rationale for using (U) not (T) is to reduce signed/unsigned issues, 78// rationale for using (U) not (T) is to reduce signed/unsigned issues,
88// as a is often a constant while b is the variable. it is still a bug, though. 79// as a is often a constant while b is the variable. it is still a bug, though.
89template<typename T, typename U> static inline T min (T a, U b) { return (U)a < b ? (U)a : b; } 80template<typename T, typename U> static inline T min (T a, U b) { return (U)a < b ? (U)a : b; }
90template<typename T, typename U> static inline T max (T a, U b) { return (U)a > b ? (U)a : b; } 81template<typename T, typename U> static inline T max (T a, U b) { return (U)a > b ? (U)a : b; }
91template<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; } 82template<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; }
92 83
84template<typename T, typename U> static inline void min_it (T &v, U m) { v = min (v, (T)m); }
85template<typename T, typename U> static inline void max_it (T &v, U m) { v = max (v, (T)m); }
86template<typename T, typename U, typename V> static inline void clamp_it (T &v, U a, V b) { v = clamp (v, (T)a, (T)b); }
87
93template<typename T, typename U> static inline void swap (T& a, U& b) { T t=a; a=(T)b; b=(U)t; } 88template<typename T, typename U> static inline void swap (T& a, U& b) { T t=a; a=(T)b; b=(U)t; }
94 89
90template<typename T, typename U, typename V> static inline T min (T a, U b, V c) { return min (a, min (b, c)); }
91template<typename T, typename U, typename V> static inline T max (T a, U b, V c) { return max (a, max (b, c)); }
92
93// sign returns -1 or +1
94template<typename T>
95static inline T sign (T v) { return v < 0 ? -1 : +1; }
96// relies on 2c representation
97template<>
98inline sint8 sign (sint8 v) { return 1 - (sint8 (uint8 (v) >> 7) * 2); }
99
100// sign0 returns -1, 0 or +1
101template<typename T>
102static inline T sign0 (T v) { return v ? sign (v) : 0; }
103
104template<typename T, typename U>
105static inline T copysign (T a, U b) { return a > 0 ? b : -b; }
106
107// div* only work correctly for div > 0
108// div, with correct rounding (< 0.5 downwards, >=0.5 upwards)
109template<typename T> static inline T div (T val, T div)
110{
111 return expect_false (val < 0) ? - ((-val + (div - 1) / 2) / div) : (val + div / 2) / div;
112}
113// div, round-up
114template<typename T> static inline T div_ru (T val, T div)
115{
116 return expect_false (val < 0) ? - ((-val ) / div) : (val + div - 1) / div;
117}
118// div, round-down
119template<typename T> static inline T div_rd (T val, T div)
120{
121 return expect_false (val < 0) ? - ((-val + (div - 1) ) / div) : (val ) / div;
122}
123
124// lerp* only work correctly for min_in < max_in
125// Linear intERPolate, scales val from min_in..max_in to min_out..max_out
95template<typename T> 126template<typename T>
96static inline T 127static inline T
97lerp (T val, T min_in, T max_in, T min_out, T max_out) 128lerp (T val, T min_in, T max_in, T min_out, T max_out)
98{ 129{
99 return (val - min_in) * (max_out - min_out) / (max_in - min_in) + min_out; 130 return min_out + div <T> ((val - min_in) * (max_out - min_out), max_in - min_in);
131}
132
133// lerp, round-down
134template<typename T>
135static inline T
136lerp_rd (T val, T min_in, T max_in, T min_out, T max_out)
137{
138 return min_out + div_rd<T> ((val - min_in) * (max_out - min_out), max_in - min_in);
139}
140
141// lerp, round-up
142template<typename T>
143static inline T
144lerp_ru (T val, T min_in, T max_in, T min_out, T max_out)
145{
146 return min_out + div_ru<T> ((val - min_in) * (max_out - min_out), max_in - min_in);
100} 147}
101 148
102// lots of stuff taken from FXT 149// lots of stuff taken from FXT
103 150
104/* Rotate right. This is used in various places for checksumming */ 151/* Rotate right. This is used in various places for checksumming */
142 int32_t d = b - a; 189 int32_t d = b - a;
143 d &= d >> 31; 190 d &= d >> 31;
144 return b - d; 191 return b - d;
145} 192}
146 193
147// this is much faster than crossfires original algorithm 194// this is much faster than crossfire's original algorithm
148// on modern cpus 195// on modern cpus
149inline int 196inline int
150isqrt (int n) 197isqrt (int n)
151{ 198{
152 return (int)sqrtf ((float)n); 199 return (int)sqrtf ((float)n);
200}
201
202// this is kind of like the ^^ operator, if it would exist, without sequence point.
203// more handy than it looks like, due to the implicit !! done on its arguments
204inline bool
205logical_xor (bool a, bool b)
206{
207 return a != b;
208}
209
210inline bool
211logical_implies (bool a, bool b)
212{
213 return a <= b;
153} 214}
154 215
155// this is only twice as fast as naive sqrtf (dx*dy+dy*dy) 216// this is only twice as fast as naive sqrtf (dx*dy+dy*dy)
156#if 0 217#if 0
157// and has a max. error of 6 in the range -100..+100. 218// and has a max. error of 6 in the range -100..+100.
182absdir (int d) 243absdir (int d)
183{ 244{
184 return ((d - 1) & 7) + 1; 245 return ((d - 1) & 7) + 1;
185} 246}
186 247
248// avoid ctz name because netbsd or freebsd spams it's namespace with it
249#if GCC_VERSION(3,4)
250static inline int least_significant_bit (uint32_t x)
251{
252 return __builtin_ctz (x);
253}
254#else
255int least_significant_bit (uint32_t x);
256#endif
257
258#define for_all_bits_sparse_32(mask, idxvar) \
259 for (uint32_t idxvar, mask_ = mask; \
260 mask_ && ((idxvar = least_significant_bit (mask_)), mask_ &= ~(1 << idxvar), 1);)
261
187extern size_t slice_alloc; // statistics 262extern ssize_t slice_alloc; // statistics
263
264void *salloc_ (int n) throw (std::bad_alloc);
265void *salloc_ (int n, void *src) throw (std::bad_alloc);
266
267// strictly the same as g_slice_alloc, but never returns 0
268template<typename T>
269inline T *salloc (int n = 1) throw (std::bad_alloc) { return (T *)salloc_ (n * sizeof (T)); }
270
271// also copies src into the new area, like "memdup"
272// if src is 0, clears the memory
273template<typename T>
274inline T *salloc (int n, T *src) throw (std::bad_alloc) { return (T *)salloc_ (n * sizeof (T), (void *)src); }
275
276// clears the memory
277template<typename T>
278inline T *salloc0(int n = 1) throw (std::bad_alloc) { return (T *)salloc_ (n * sizeof (T), 0); }
279
280// for symmetry
281template<typename T>
282inline void sfree (T *ptr, int n = 1) throw ()
283{
284 if (expect_true (ptr))
285 {
286 slice_alloc -= n * sizeof (T);
287 if (DEBUG_POISON) memset (ptr, DEBUG_POISON, n * sizeof (T));
288 g_slice_free1 (n * sizeof (T), (void *)ptr);
289 assert (slice_alloc >= 0);//D
290 }
291}
292
293// nulls the pointer
294template<typename T>
295inline void sfree0 (T *&ptr, int n = 1) throw ()
296{
297 sfree<T> (ptr, n);
298 ptr = 0;
299}
188 300
189// makes dynamically allocated objects zero-initialised 301// makes dynamically allocated objects zero-initialised
190struct zero_initialised 302struct zero_initialised
191{ 303{
192 void *operator new (size_t s, void *p) 304 void *operator new (size_t s, void *p)
195 return p; 307 return p;
196 } 308 }
197 309
198 void *operator new (size_t s) 310 void *operator new (size_t s)
199 { 311 {
200 slice_alloc += s;
201 return g_slice_alloc0 (s); 312 return salloc0<char> (s);
202 } 313 }
203 314
204 void *operator new[] (size_t s) 315 void *operator new[] (size_t s)
205 { 316 {
206 slice_alloc += s;
207 return g_slice_alloc0 (s); 317 return salloc0<char> (s);
208 } 318 }
209 319
210 void operator delete (void *p, size_t s) 320 void operator delete (void *p, size_t s)
211 { 321 {
212 slice_alloc -= s; 322 sfree ((char *)p, s);
213 g_slice_free1 (s, p);
214 } 323 }
215 324
216 void operator delete[] (void *p, size_t s) 325 void operator delete[] (void *p, size_t s)
217 { 326 {
218 slice_alloc -= s; 327 sfree ((char *)p, s);
219 g_slice_free1 (s, p);
220 } 328 }
221}; 329};
222 330
223void *salloc_ (int n) throw (std::bad_alloc); 331// makes dynamically allocated objects zero-initialised
224void *salloc_ (int n, void *src) throw (std::bad_alloc); 332struct slice_allocated
225
226// strictly the same as g_slice_alloc, but never returns 0
227template<typename T>
228inline T *salloc (int n = 1) throw (std::bad_alloc) { return (T *)salloc_ (n * sizeof (T)); }
229
230// also copies src into the new area, like "memdup"
231// if src is 0, clears the memory
232template<typename T>
233inline T *salloc (int n, T *src) throw (std::bad_alloc) { return (T *)salloc_ (n * sizeof (T), (void *)src); }
234
235// clears the memory
236template<typename T>
237inline T *salloc0(int n = 1) throw (std::bad_alloc) { return (T *)salloc_ (n * sizeof (T), 0); }
238
239// for symmetry
240template<typename T>
241inline void sfree (T *ptr, int n = 1) throw ()
242{ 333{
243#ifdef PREFER_MALLOC 334 void *operator new (size_t s, void *p)
244 free (ptr); 335 {
245#else 336 return p;
246 slice_alloc -= n * sizeof (T); 337 }
247 g_slice_free1 (n * sizeof (T), (void *)ptr); 338
248#endif 339 void *operator new (size_t s)
249} 340 {
341 return salloc<char> (s);
342 }
343
344 void *operator new[] (size_t s)
345 {
346 return salloc<char> (s);
347 }
348
349 void operator delete (void *p, size_t s)
350 {
351 sfree ((char *)p, s);
352 }
353
354 void operator delete[] (void *p, size_t s)
355 {
356 sfree ((char *)p, s);
357 }
358};
250 359
251// a STL-compatible allocator that uses g_slice 360// a STL-compatible allocator that uses g_slice
252// boy, this is verbose 361// boy, this is verbose
253template<typename Tp> 362template<typename Tp>
254struct slice_allocator 363struct slice_allocator
266 { 375 {
267 typedef slice_allocator<U> other; 376 typedef slice_allocator<U> other;
268 }; 377 };
269 378
270 slice_allocator () throw () { } 379 slice_allocator () throw () { }
271 slice_allocator (const slice_allocator &o) throw () { } 380 slice_allocator (const slice_allocator &) throw () { }
272 template<typename Tp2> 381 template<typename Tp2>
273 slice_allocator (const slice_allocator<Tp2> &) throw () { } 382 slice_allocator (const slice_allocator<Tp2> &) throw () { }
274 383
275 ~slice_allocator () { } 384 ~slice_allocator () { }
276 385
285 void deallocate (pointer p, size_type n) 394 void deallocate (pointer p, size_type n)
286 { 395 {
287 sfree<Tp> (p, n); 396 sfree<Tp> (p, n);
288 } 397 }
289 398
290 size_type max_size ()const throw () 399 size_type max_size () const throw ()
291 { 400 {
292 return size_t (-1) / sizeof (Tp); 401 return size_t (-1) / sizeof (Tp);
293 } 402 }
294 403
295 void construct (pointer p, const Tp &val) 404 void construct (pointer p, const Tp &val)
306// P. L'Ecuyer, “Maximally Equidistributed Combined Tausworthe Generators”, Mathematics of Computation, 65, 213 (1996), 203–213. 415// P. L'Ecuyer, “Maximally Equidistributed Combined Tausworthe Generators”, Mathematics of Computation, 65, 213 (1996), 203–213.
307// http://www.iro.umontreal.ca/~lecuyer/myftp/papers/tausme.ps 416// http://www.iro.umontreal.ca/~lecuyer/myftp/papers/tausme.ps
308// http://www.iro.umontreal.ca/~lecuyer/myftp/papers/tausme2.ps 417// http://www.iro.umontreal.ca/~lecuyer/myftp/papers/tausme2.ps
309struct tausworthe_random_generator 418struct tausworthe_random_generator
310{ 419{
311 // generator
312 uint32_t state [4]; 420 uint32_t state [4];
313 421
314 void operator =(const tausworthe_random_generator &src) 422 void operator =(const tausworthe_random_generator &src)
315 { 423 {
316 state [0] = src.state [0]; 424 state [0] = src.state [0];
319 state [3] = src.state [3]; 427 state [3] = src.state [3];
320 } 428 }
321 429
322 void seed (uint32_t seed); 430 void seed (uint32_t seed);
323 uint32_t next (); 431 uint32_t next ();
432};
324 433
325 // uniform distribution 434// Xorshift RNGs, George Marsaglia
435// http://www.jstatsoft.org/v08/i14/paper
436// this one is about 40% faster than the tausworthe one above (i.e. not much),
437// despite the inlining, and has the issue of only creating 2**32-1 numbers.
438// see also http://www.iro.umontreal.ca/~lecuyer/myftp/papers/xorshift.pdf
439struct xorshift_random_generator
440{
441 uint32_t x, y;
442
443 void operator =(const xorshift_random_generator &src)
444 {
445 x = src.x;
446 y = src.y;
447 }
448
449 void seed (uint32_t seed)
450 {
451 x = seed;
452 y = seed * 69069U;
453 }
454
455 uint32_t next ()
456 {
457 uint32_t t = x ^ (x << 10);
458 x = y;
459 y = y ^ (y >> 13) ^ t ^ (t >> 10);
460 return y;
461 }
462};
463
464template<class generator>
465struct random_number_generator : generator
466{
467 // uniform distribution, 0 .. max (0, num - 1)
326 uint32_t operator ()(uint32_t num) 468 uint32_t operator ()(uint32_t num)
327 { 469 {
328 return is_constant (num) 470 return !is_constant (num) ? get_range (num) // non-constant
329 ? (next () * (uint64_t)num) >> 32U 471 : num & (num - 1) ? (this->next () * (uint64_t)num) >> 32U // constant, non-power-of-two
330 : get_range (num); 472 : this->next () & (num - 1); // constant, power-of-two
331 } 473 }
332 474
333 // return a number within (min .. max) 475 // return a number within the closed interval [min .. max]
334 int operator () (int r_min, int r_max) 476 int operator () (int r_min, int r_max)
335 { 477 {
336 return is_constant (r_min) && is_constant (r_max) && r_min <= r_max 478 return is_constant (r_min) && is_constant (r_max) && r_min <= r_max
337 ? r_min + operator ()(r_max - r_min + 1) 479 ? r_min + operator ()(r_max - r_min + 1)
338 : get_range (r_min, r_max); 480 : get_range (r_min, r_max);
339 } 481 }
340 482
483 // return a number within the closed interval [0..1]
341 double operator ()() 484 double operator ()()
342 { 485 {
343 return this->next () / (double)0xFFFFFFFFU; 486 return this->next () / (double)0xFFFFFFFFU;
344 } 487 }
345 488
346protected: 489protected:
347 uint32_t get_range (uint32_t r_max); 490 uint32_t get_range (uint32_t r_max);
348 int get_range (int r_min, int r_max); 491 int get_range (int r_min, int r_max);
349}; 492};
350 493
351typedef tausworthe_random_generator rand_gen; 494typedef random_number_generator<tausworthe_random_generator> rand_gen;
352 495
353extern rand_gen rndm; 496extern rand_gen rndm, rmg_rndm;
354 497
355INTERFACE_CLASS (attachable) 498INTERFACE_CLASS (attachable)
356struct refcnt_base 499struct refcnt_base
357{ 500{
358 typedef int refcnt_t; 501 typedef int refcnt_t;
421typedef refptr<object> object_ptr; 564typedef refptr<object> object_ptr;
422typedef refptr<archetype> arch_ptr; 565typedef refptr<archetype> arch_ptr;
423typedef refptr<client> client_ptr; 566typedef refptr<client> client_ptr;
424typedef refptr<player> player_ptr; 567typedef refptr<player> player_ptr;
425 568
569#define STRHSH_NULL 2166136261
570
571static inline uint32_t
572strhsh (const char *s)
573{
574 // use FNV-1a hash (http://isthe.com/chongo/tech/comp/fnv/)
575 // it is about twice as fast as the one-at-a-time one,
576 // with good distribution.
577 // FNV-1a is faster on many cpus because the multiplication
578 // runs concurrently with the looping logic.
579 uint32_t hash = STRHSH_NULL;
580
581 while (*s)
582 hash = (hash ^ *s++) * 16777619U;
583
584 return hash;
585}
586
587static inline uint32_t
588memhsh (const char *s, size_t len)
589{
590 uint32_t hash = STRHSH_NULL;
591
592 while (len--)
593 hash = (hash ^ *s++) * 16777619U;
594
595 return hash;
596}
597
426struct str_hash 598struct str_hash
427{ 599{
428 std::size_t operator ()(const char *s) const 600 std::size_t operator ()(const char *s) const
429 { 601 {
430 unsigned long hash = 0;
431
432 /* use the one-at-a-time hash function, which supposedly is
433 * better than the djb2-like one used by perl5.005, but
434 * certainly is better then the bug used here before.
435 * see http://burtleburtle.net/bob/hash/doobs.html
436 */
437 while (*s)
438 {
439 hash += *s++;
440 hash += hash << 10;
441 hash ^= hash >> 6;
442 }
443
444 hash += hash << 3;
445 hash ^= hash >> 11;
446 hash += hash << 15;
447
448 return hash; 602 return strhsh (s);
603 }
604
605 std::size_t operator ()(const shstr &s) const
606 {
607 return strhsh (s);
449 } 608 }
450}; 609};
451 610
452struct str_equal 611struct str_equal
453{ 612{
546 erase (&obj); 705 erase (&obj);
547 } 706 }
548}; 707};
549 708
550// basically does what strncpy should do, but appends "..." to strings exceeding length 709// basically does what strncpy should do, but appends "..." to strings exceeding length
710// returns the number of bytes actually used (including \0)
551void assign (char *dst, const char *src, int maxlen); 711int assign (char *dst, const char *src, int maxsize);
552 712
553// type-safe version of assign 713// type-safe version of assign
554template<int N> 714template<int N>
555inline void assign (char (&dst)[N], const char *src) 715inline int assign (char (&dst)[N], const char *src)
556{ 716{
557 assign ((char *)&dst, src, N); 717 return assign ((char *)&dst, src, N);
558} 718}
559 719
560typedef double tstamp; 720typedef double tstamp;
561 721
562// return current time as timestamp 722// return current time as timestamp
563tstamp now (); 723tstamp now ();
564 724
565int similar_direction (int a, int b); 725int similar_direction (int a, int b);
566 726
567// like sprintf, but returns a "static" buffer 727// like v?sprintf, but returns a "static" buffer
568const char *format (const char *format, ...); 728char *vformat (const char *format, va_list ap);
729char *format (const char *format, ...) attribute ((format (printf, 1, 2)));
569 730
731// safety-check player input which will become object->msg
732bool msg_is_safe (const char *msg);
733
734/////////////////////////////////////////////////////////////////////////////
735// threads, very very thin wrappers around pthreads
736
737struct thread
738{
739 pthread_t id;
740
741 void start (void *(*start_routine)(void *), void *arg = 0);
742
743 void cancel ()
744 {
745 pthread_cancel (id);
746 }
747
748 void *join ()
749 {
750 void *ret;
751
752 if (pthread_join (id, &ret))
753 cleanup ("pthread_join failed", 1);
754
755 return ret;
756 }
757};
758
759// note that mutexes are not classes
760typedef pthread_mutex_t smutex;
761
762#if __linux && defined (PTHREAD_ADAPTIVE_MUTEX_INITIALIZER_NP)
763 #define SMUTEX_INITIALISER PTHREAD_ADAPTIVE_MUTEX_INITIALIZER_NP
764#else
765 #define SMUTEX_INITIALISER PTHREAD_MUTEX_INITIALIZER
570#endif 766#endif
571 767
768#define SMUTEX(name) smutex name = SMUTEX_INITIALISER
769#define SMUTEX_LOCK(name) pthread_mutex_lock (&(name))
770#define SMUTEX_UNLOCK(name) pthread_mutex_unlock (&(name))
771
772typedef pthread_cond_t scond;
773
774#define SCOND(name) scond name = PTHREAD_COND_INITIALIZER
775#define SCOND_SIGNAL(name) pthread_cond_signal (&(name))
776#define SCOND_BROADCAST(name) pthread_cond_broadcast (&(name))
777#define SCOND_WAIT(name,mutex) pthread_cond_wait (&(name), &(mutex))
778
779#endif
780

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines