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.104 by root, Thu Apr 29 21:21:34 2010 UTC vs.
Revision 1.128 by root, Tue Nov 27 18:47:35 2018 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 (©) 2017,2018 Marc Alexander Lehmann / the Deliantra team
4 * Copyright (©) 2005,2006,2007,2008,2009,2010 Marc Alexander Lehmann / Robin Redeker / the Deliantra team 5 * Copyright (©) 2005,2006,2007,2008,2009,2010,2011,2012,2013,2014,2015,2016 Marc Alexander Lehmann / Robin Redeker / the Deliantra team
5 * 6 *
6 * Deliantra is free software: you can redistribute it and/or modify it under 7 * 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 8 * 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 9 * Free Software Foundation, either version 3 of the License, or (at your
9 * option) any later version. 10 * option) any later version.
10 * 11 *
11 * This program is distributed in the hope that it will be useful, 12 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details. 15 * GNU General Public License for more details.
15 * 16 *
16 * You should have received a copy of the Affero GNU General Public License 17 * You should have received a copy of the Affero GNU General Public License
17 * and the GNU General Public License along with this program. If not, see 18 * and the GNU General Public License along with this program. If not, see
18 * <http://www.gnu.org/licenses/>. 19 * <http://www.gnu.org/licenses/>.
19 * 20 *
20 * The authors can be reached via e-mail to <support@deliantra.net> 21 * The authors can be reached via e-mail to <support@deliantra.net>
21 */ 22 */
22 23
23#ifndef UTIL_H__ 24#ifndef UTIL_H__
24#define UTIL_H__ 25#define UTIL_H__
35#include <cmath> 36#include <cmath>
36#include <new> 37#include <new>
37#include <vector> 38#include <vector>
38 39
39#include <glib.h> 40#include <glib.h>
41
42#include <flat_hash_map.hpp>
40 43
41#include <shstr.h> 44#include <shstr.h>
42#include <traits.h> 45#include <traits.h>
43 46
44#if DEBUG_SALLOC 47#if DEBUG_SALLOC
55#endif 58#endif
56 59
57// use C0X decltype for auto declarations until ISO C++ sanctifies them (if ever) 60// use C0X decltype for auto declarations until ISO C++ sanctifies them (if ever)
58#define auto(var,expr) decltype(expr) var = (expr) 61#define auto(var,expr) decltype(expr) var = (expr)
59 62
60// could use the sizeof (arr) /( sizeof (arr [0]) here, but C++ is 63#if cplusplus_does_not_suck /* still sucks in codesize with gcc 6, although local types work now */
61// much more obfuscated... :) 64// does not work for local types (http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2657.htm)
62
63template<typename T, int N> 65template<typename T, int N>
64inline int array_length (const T (&arr)[N]) 66static inline int array_length (const T (&arr)[N])
65{ 67{
66 return N; 68 return N;
67} 69}
70#else
71#define array_length(name) (sizeof (name) / sizeof (name [0]))
72#endif
68 73
69// very ugly macro that basically declares and initialises a variable 74// very ugly macro that basically declares and initialises a variable
70// that is in scope for the next statement only 75// that is in scope for the next statement only
71// works only for stuff that can be assigned 0 and converts to false 76// works only for stuff that can be assigned 0 and converts to false
72// (note: works great for pointers) 77// (note: works great for pointers)
79 84
80// in range excluding end 85// in range excluding end
81#define IN_RANGE_EXC(val,beg,end) \ 86#define IN_RANGE_EXC(val,beg,end) \
82 ((unsigned int)(val) - (unsigned int)(beg) < (unsigned int)(end) - (unsigned int)(beg)) 87 ((unsigned int)(val) - (unsigned int)(beg) < (unsigned int)(end) - (unsigned int)(beg))
83 88
84void cleanup (const char *cause, bool make_core = false); 89ecb_cold void cleanup (const char *cause, bool make_core = false);
85void fork_abort (const char *msg); 90ecb_cold void fork_abort (const char *msg);
86 91
87// rationale for using (U) not (T) is to reduce signed/unsigned issues, 92// 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. 93// 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; } 94template<typename T, typename U> static inline T min (T a, U b) { return a < (T)b ? a : (T)b; }
90template<typename T, typename U> static inline T max (T a, U b) { return (U)a > b ? (U)a : b; } 95template<typename T, typename U> static inline T max (T a, U b) { return a > (T)b ? a : (T)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; } 96template<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 97
93template<typename T, typename U> static inline void min_it (T &v, U m) { v = min (v, (T)m); } 98template<typename T, typename U> static inline void min_it (T &v, U m) { v = min (v, (T)m); }
94template<typename T, typename U> static inline void max_it (T &v, U m) { v = max (v, (T)m); } 99template<typename T, typename U> static inline void max_it (T &v, U m) { v = max (v, (T)m); }
95template<typename T, typename U, typename V> static inline void clamp_it (T &v, U a, V b) { v = clamp (v, (T)a, (T)b); } 100template<typename T, typename U, typename V> static inline void clamp_it (T &v, U a, V b) { v = clamp (v, (T)a, (T)b); }
112 117
113// sign0 returns -1, 0 or +1 118// sign0 returns -1, 0 or +1
114template<typename T> 119template<typename T>
115static inline T sign0 (T v) { return v ? sign (v) : 0; } 120static inline T sign0 (T v) { return v ? sign (v) : 0; }
116 121
122//clashes with C++0x
117template<typename T, typename U> 123template<typename T, typename U>
118static inline T copysign (T a, U b) { return a > 0 ? b : -b; } 124static inline T copysign (T a, U b) { return a > 0 ? b : -b; }
119 125
120// div* only work correctly for div > 0 126// div* only work correctly for div > 0
121// div, with correct rounding (< 0.5 downwards, >=0.5 upwards) 127// div, with correct rounding (< 0.5 downwards, >=0.5 upwards)
122template<typename T> static inline T div (T val, T div) 128template<typename T> static inline T div (T val, T div)
123{ 129{
124 return expect_false (val < 0) ? - ((-val + (div - 1) / 2) / div) : (val + div / 2) / div; 130 return expect_false (val < 0) ? - ((-val + (div - 1) / 2) / div) : (val + div / 2) / div;
125} 131}
132
133template<> inline float div (float val, float div) { return val / div; }
134template<> inline double div (double val, double div) { return val / div; }
135
126// div, round-up 136// div, round-up
127template<typename T> static inline T div_ru (T val, T div) 137template<typename T> static inline T div_ru (T val, T div)
128{ 138{
129 return expect_false (val < 0) ? - ((-val ) / div) : (val + div - 1) / div; 139 return expect_false (val < 0) ? - ((-val ) / div) : (val + div - 1) / div;
130} 140}
230#if 0 240#if 0
231// and has a max. error of 6 in the range -100..+100. 241// and has a max. error of 6 in the range -100..+100.
232#else 242#else
233// and has a max. error of 9 in the range -100..+100. 243// and has a max. error of 9 in the range -100..+100.
234#endif 244#endif
235inline int 245inline int
236idistance (int dx, int dy) 246idistance (int dx, int dy)
237{ 247{
238 unsigned int dx_ = abs (dx); 248 unsigned int dx_ = abs (dx);
239 unsigned int dy_ = abs (dy); 249 unsigned int dy_ = abs (dy);
240 250
241#if 0 251#if 0
242 return dx_ > dy_ 252 return dx_ > dy_
245#else 255#else
246 return dx_ + dy_ - min (dx_, dy_) * 5 / 8; 256 return dx_ + dy_ - min (dx_, dy_) * 5 / 8;
247#endif 257#endif
248} 258}
249 259
260// can be substantially faster than floor, if your value range allows for it
261template<typename T>
262inline T
263fastfloor (T x)
264{
265 return std::floor (x);
266}
267
268inline float
269fastfloor (float x)
270{
271 return sint32(x) - (x < 0);
272}
273
274inline double
275fastfloor (double x)
276{
277 return sint64(x) - (x < 0);
278}
279
250/* 280/*
251 * absdir(int): Returns a number between 1 and 8, which represent 281 * absdir(int): Returns a number between 1 and 8, which represent
252 * the "absolute" direction of a number (it actually takes care of 282 * the "absolute" direction of a number (it actually takes care of
253 * "overflow" in previous calculations of a direction). 283 * "overflow" in previous calculations of a direction).
254 */ 284 */
256absdir (int d) 286absdir (int d)
257{ 287{
258 return ((d - 1) & 7) + 1; 288 return ((d - 1) & 7) + 1;
259} 289}
260 290
261// avoid ctz name because netbsd or freebsd spams it's namespace with it
262#if GCC_VERSION(3,4)
263static inline int least_significant_bit (uint32_t x)
264{
265 return __builtin_ctz (x);
266}
267#else
268int least_significant_bit (uint32_t x);
269#endif
270
271#define for_all_bits_sparse_32(mask, idxvar) \ 291#define for_all_bits_sparse_32(mask, idxvar) \
272 for (uint32_t idxvar, mask_ = mask; \ 292 for (uint32_t idxvar, mask_ = mask; \
273 mask_ && ((idxvar = least_significant_bit (mask_)), mask_ &= ~(1 << idxvar), 1);) 293 mask_ && ((idxvar = ecb_ctz32 (mask_)), mask_ &= ~(1 << idxvar), 1);)
274 294
275extern ssize_t slice_alloc; // statistics 295extern ssize_t slice_alloc; // statistics
276 296
277void *salloc_ (int n) throw (std::bad_alloc); 297void *salloc_ (int n);
278void *salloc_ (int n, void *src) throw (std::bad_alloc); 298void *salloc_ (int n, void *src);
279 299
280// strictly the same as g_slice_alloc, but never returns 0 300// strictly the same as g_slice_alloc, but never returns 0
281template<typename T> 301template<typename T>
282inline T *salloc (int n = 1) throw (std::bad_alloc) { return (T *)salloc_ (n * sizeof (T)); } 302inline T *salloc (int n = 1) { return (T *)salloc_ (n * sizeof (T)); }
283 303
284// also copies src into the new area, like "memdup" 304// also copies src into the new area, like "memdup"
285// if src is 0, clears the memory 305// if src is 0, clears the memory
286template<typename T> 306template<typename T>
287inline T *salloc (int n, T *src) throw (std::bad_alloc) { return (T *)salloc_ (n * sizeof (T), (void *)src); } 307inline T *salloc (int n, T *src) { return (T *)salloc_ (n * sizeof (T), (void *)src); }
288 308
289// clears the memory 309// clears the memory
290template<typename T> 310template<typename T>
291inline T *salloc0(int n = 1) throw (std::bad_alloc) { return (T *)salloc_ (n * sizeof (T), 0); } 311inline T *salloc0(int n = 1) { return (T *)salloc_ (n * sizeof (T), 0); }
292 312
293// for symmetry 313// for symmetry
294template<typename T> 314template<typename T>
295inline void sfree (T *ptr, int n = 1) throw () 315inline void sfree (T *ptr, int n = 1) noexcept
296{ 316{
297 if (expect_true (ptr)) 317 if (expect_true (ptr))
298 { 318 {
299 slice_alloc -= n * sizeof (T); 319 slice_alloc -= n * sizeof (T);
300 if (DEBUG_POISON) memset (ptr, DEBUG_POISON, n * sizeof (T)); 320 if (DEBUG_POISON) memset (ptr, DEBUG_POISON, n * sizeof (T));
301 g_slice_free1 (n * sizeof (T), (void *)ptr); 321 g_slice_free1 (n * sizeof (T), (void *)ptr);
302 assert (slice_alloc >= 0);//D
303 } 322 }
304} 323}
305 324
306// nulls the pointer 325// nulls the pointer
307template<typename T> 326template<typename T>
308inline void sfree0 (T *&ptr, int n = 1) throw () 327inline void sfree0 (T *&ptr, int n = 1) noexcept
309{ 328{
310 sfree<T> (ptr, n); 329 sfree<T> (ptr, n);
311 ptr = 0; 330 ptr = 0;
312} 331}
313 332
381 typedef const Tp *const_pointer; 400 typedef const Tp *const_pointer;
382 typedef Tp &reference; 401 typedef Tp &reference;
383 typedef const Tp &const_reference; 402 typedef const Tp &const_reference;
384 typedef Tp value_type; 403 typedef Tp value_type;
385 404
386 template <class U> 405 template <class U>
387 struct rebind 406 struct rebind
388 { 407 {
389 typedef slice_allocator<U> other; 408 typedef slice_allocator<U> other;
390 }; 409 };
391 410
392 slice_allocator () throw () { } 411 slice_allocator () noexcept { }
393 slice_allocator (const slice_allocator &) throw () { } 412 slice_allocator (const slice_allocator &) noexcept { }
394 template<typename Tp2> 413 template<typename Tp2>
395 slice_allocator (const slice_allocator<Tp2> &) throw () { } 414 slice_allocator (const slice_allocator<Tp2> &) noexcept { }
396 415
397 ~slice_allocator () { } 416 ~slice_allocator () { }
398 417
399 pointer address (reference x) const { return &x; } 418 pointer address (reference x) const { return &x; }
400 const_pointer address (const_reference x) const { return &x; } 419 const_pointer address (const_reference x) const { return &x; }
407 void deallocate (pointer p, size_type n) 426 void deallocate (pointer p, size_type n)
408 { 427 {
409 sfree<Tp> (p, n); 428 sfree<Tp> (p, n);
410 } 429 }
411 430
412 size_type max_size () const throw () 431 size_type max_size () const noexcept
413 { 432 {
414 return size_t (-1) / sizeof (Tp); 433 return size_t (-1) / sizeof (Tp);
415 } 434 }
416 435
417 void construct (pointer p, const Tp &val) 436 void construct (pointer p, const Tp &val)
423 { 442 {
424 p->~Tp (); 443 p->~Tp ();
425 } 444 }
426}; 445};
427 446
428// P. L'Ecuyer, “Maximally Equidistributed Combined Tausworthe Generators”, Mathematics of Computation, 65, 213 (1996), 203–213. 447// basically a memory area, but refcounted
429// http://www.iro.umontreal.ca/~lecuyer/myftp/papers/tausme.ps 448struct refcnt_buf
430// http://www.iro.umontreal.ca/~lecuyer/myftp/papers/tausme2.ps
431struct tausworthe_random_generator
432{ 449{
433 uint32_t state [4]; 450 char *data;
434 451
435 void operator =(const tausworthe_random_generator &src) 452 refcnt_buf (size_t size = 0);
436 { 453 refcnt_buf (void *data, size_t size);
437 state [0] = src.state [0];
438 state [1] = src.state [1];
439 state [2] = src.state [2];
440 state [3] = src.state [3];
441 }
442 454
443 void seed (uint32_t seed); 455 refcnt_buf (const refcnt_buf &src)
444 uint32_t next ();
445};
446
447// Xorshift RNGs, George Marsaglia
448// http://www.jstatsoft.org/v08/i14/paper
449// this one is about 40% faster than the tausworthe one above (i.e. not much),
450// despite the inlining, and has the issue of only creating 2**32-1 numbers.
451// see also http://www.iro.umontreal.ca/~lecuyer/myftp/papers/xorshift.pdf
452struct xorshift_random_generator
453{
454 uint32_t x, y;
455
456 void operator =(const xorshift_random_generator &src)
457 { 456 {
458 x = src.x; 457 data = src.data;
459 y = src.y; 458 inc ();
460 } 459 }
461 460
462 void seed (uint32_t seed) 461 ~refcnt_buf ();
463 {
464 x = seed;
465 y = seed * 69069U;
466 }
467 462
468 uint32_t next () 463 refcnt_buf &operator =(const refcnt_buf &src);
464
465 operator char *()
469 { 466 {
470 uint32_t t = x ^ (x << 10);
471 x = y;
472 y = y ^ (y >> 13) ^ t ^ (t >> 10);
473 return y; 467 return data;
474 } 468 }
475};
476 469
477template<class generator> 470 size_t size () const
478struct random_number_generator : generator
479{
480 // uniform distribution, 0 .. max (0, num - 1)
481 uint32_t operator ()(uint32_t num)
482 { 471 {
483 return !is_constant (num) ? get_range (num) // non-constant 472 return _size ();
484 : num & (num - 1) ? (this->next () * (uint64_t)num) >> 32U // constant, non-power-of-two
485 : this->next () & (num - 1); // constant, power-of-two
486 }
487
488 // return a number within the closed interval [min .. max]
489 int operator () (int r_min, int r_max)
490 {
491 return is_constant (r_min <= r_max) && r_min <= r_max
492 ? r_min + operator ()(r_max - r_min + 1)
493 : get_range (r_min, r_max);
494 }
495
496 // return a number within the closed interval [0..1]
497 double operator ()()
498 {
499 return this->next () / (double)0xFFFFFFFFU;
500 } 473 }
501 474
502protected: 475protected:
503 uint32_t get_range (uint32_t r_max); 476 enum {
504 int get_range (int r_min, int r_max); 477 overhead = sizeof (uint32_t) * 2
505}; 478 };
506 479
507typedef random_number_generator<tausworthe_random_generator> rand_gen; 480 uint32_t &_size () const
481 {
482 return ((unsigned int *)data)[-2];
483 }
508 484
509extern rand_gen rndm, rmg_rndm; 485 uint32_t &_refcnt () const
486 {
487 return ((unsigned int *)data)[-1];
488 }
489
490 void _alloc (uint32_t size)
491 {
492 data = ((char *)salloc<char> (size + overhead)) + overhead;
493 _size () = size;
494 _refcnt () = 1;
495 }
496
497 void _dealloc ();
498
499 void inc ()
500 {
501 ++_refcnt ();
502 }
503
504 void dec ()
505 {
506 if (!--_refcnt ())
507 _dealloc ();
508 }
509};
510 510
511INTERFACE_CLASS (attachable) 511INTERFACE_CLASS (attachable)
512struct refcnt_base 512struct refcnt_base
513{ 513{
514 typedef int refcnt_t; 514 typedef int refcnt_t;
529 // p if not null 529 // p if not null
530 refcnt_base::refcnt_t *refcnt_ref () { return p ? &p->refcnt : &refcnt_dummy; } 530 refcnt_base::refcnt_t *refcnt_ref () { return p ? &p->refcnt : &refcnt_dummy; }
531 531
532 void refcnt_dec () 532 void refcnt_dec ()
533 { 533 {
534 if (!is_constant (p)) 534 if (!ecb_is_constant (p))
535 --*refcnt_ref (); 535 --*refcnt_ref ();
536 else if (p) 536 else if (p)
537 --p->refcnt; 537 --p->refcnt;
538 } 538 }
539 539
540 void refcnt_inc () 540 void refcnt_inc ()
541 { 541 {
542 if (!is_constant (p)) 542 if (!ecb_is_constant (p))
543 ++*refcnt_ref (); 543 ++*refcnt_ref ();
544 else if (p) 544 else if (p)
545 ++p->refcnt; 545 ++p->refcnt;
546 } 546 }
547 547
588 // use FNV-1a hash (http://isthe.com/chongo/tech/comp/fnv/) 588 // use FNV-1a hash (http://isthe.com/chongo/tech/comp/fnv/)
589 // it is about twice as fast as the one-at-a-time one, 589 // it is about twice as fast as the one-at-a-time one,
590 // with good distribution. 590 // with good distribution.
591 // FNV-1a is faster on many cpus because the multiplication 591 // FNV-1a is faster on many cpus because the multiplication
592 // runs concurrently with the looping logic. 592 // runs concurrently with the looping logic.
593 // we modify the hash a bit to improve its distribution
593 uint32_t hash = STRHSH_NULL; 594 uint32_t hash = STRHSH_NULL;
594 595
595 while (*s) 596 while (*s)
596 hash = (hash ^ *s++) * 16777619U; 597 hash = (hash ^ *s++) * 16777619U;
597 598
598 return hash; 599 return hash ^ (hash >> 16);
599} 600}
600 601
601static inline uint32_t 602static inline uint32_t
602memhsh (const char *s, size_t len) 603memhsh (const char *s, size_t len)
603{ 604{
604 uint32_t hash = STRHSH_NULL; 605 uint32_t hash = STRHSH_NULL;
605 606
606 while (len--) 607 while (len--)
607 hash = (hash ^ *s++) * 16777619U; 608 hash = (hash ^ *s++) * 16777619U;
608 609
609 return hash; 610 return hash;
610} 611}
618 619
619 std::size_t operator ()(const shstr &s) const 620 std::size_t operator ()(const shstr &s) const
620 { 621 {
621 return strhsh (s); 622 return strhsh (s);
622 } 623 }
624
625 typedef ska::power_of_two_hash_policy hash_policy;
623}; 626};
624 627
625struct str_equal 628struct str_equal
626{ 629{
627 bool operator ()(const char *a, const char *b) const 630 bool operator ()(const char *a, const char *b) const
653 } 656 }
654}; 657};
655 658
656// This container blends advantages of linked lists 659// This container blends advantages of linked lists
657// (efficiency) with vectors (random access) by 660// (efficiency) with vectors (random access) by
658// by using an unordered vector and storing the vector 661// using an unordered vector and storing the vector
659// index inside the object. 662// index inside the object.
660// 663//
661// + memory-efficient on most 64 bit archs 664// + memory-efficient on most 64 bit archs
662// + O(1) insert/remove 665// + O(1) insert/remove
663// + free unique (but varying) id for inserted objects 666// + free unique (but varying) id for inserted objects
700 insert (&obj); 703 insert (&obj);
701 } 704 }
702 705
703 void erase (T *obj) 706 void erase (T *obj)
704 { 707 {
705 unsigned int pos = obj->*indexmember; 708 object_vector_index pos = obj->*indexmember;
706 obj->*indexmember = 0; 709 obj->*indexmember = 0;
707 710
708 if (pos < this->size ()) 711 if (pos < this->size ())
709 { 712 {
710 (*this)[pos - 1] = (*this)[this->size () - 1]; 713 (*this)[pos - 1] = (*this)[this->size () - 1];
718 { 721 {
719 erase (&obj); 722 erase (&obj);
720 } 723 }
721}; 724};
722 725
726/////////////////////////////////////////////////////////////////////////////
727
728// something like a vector or stack, but without
729// out of bounds checking
730template<typename T>
731struct fixed_stack
732{
733 T *data;
734 int size;
735 int max;
736
737 fixed_stack ()
738 : size (0), data (0)
739 {
740 }
741
742 fixed_stack (int max)
743 : size (0), max (max)
744 {
745 data = salloc<T> (max);
746 }
747
748 void reset (int new_max)
749 {
750 sfree (data, max);
751 size = 0;
752 max = new_max;
753 data = salloc<T> (max);
754 }
755
756 void free ()
757 {
758 sfree (data, max);
759 data = 0;
760 }
761
762 ~fixed_stack ()
763 {
764 sfree (data, max);
765 }
766
767 T &operator[](int idx)
768 {
769 return data [idx];
770 }
771
772 void push (T v)
773 {
774 data [size++] = v;
775 }
776
777 T &pop ()
778 {
779 return data [--size];
780 }
781
782 T remove (int idx)
783 {
784 T v = data [idx];
785
786 data [idx] = data [--size];
787
788 return v;
789 }
790};
791
792/////////////////////////////////////////////////////////////////////////////
793
723// basically does what strncpy should do, but appends "..." to strings exceeding length 794// basically does what strncpy should do, but appends "..." to strings exceeding length
724// returns the number of bytes actually used (including \0) 795// returns the number of bytes actually used (including \0)
725int assign (char *dst, const char *src, int maxsize); 796int assign (char *dst, const char *src, int maxsize);
726 797
727// type-safe version of assign 798// type-safe version of assign
738 809
739int similar_direction (int a, int b); 810int similar_direction (int a, int b);
740 811
741// like v?sprintf, but returns a "static" buffer 812// like v?sprintf, but returns a "static" buffer
742char *vformat (const char *format, va_list ap); 813char *vformat (const char *format, va_list ap);
743char *format (const char *format, ...) attribute ((format (printf, 1, 2))); 814char *format (const char *format, ...) ecb_attribute ((format (printf, 1, 2)));
744 815
745// safety-check player input which will become object->msg 816// safety-check player input which will become object->msg
746bool msg_is_safe (const char *msg); 817bool msg_is_safe (const char *msg);
747 818
748///////////////////////////////////////////////////////////////////////////// 819/////////////////////////////////////////////////////////////////////////////

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines