pike.git/ src/ builtin_functions.c

2001-01-31

2001-01-31 13:27:49 by Henrik Grubbström (Grubba) <grubba@grubba.org>

• ce4d673123fb414248a8322a928c9c832ef24515 (30 lines) (+29/-1) ^{[ Show | Annotate ]}
  Branch: 7.9

Added some AutoDoc mk II markup.

Rev: src/builtin_functions.c:1.334
Rev: src/mapping.c:1.116
Rev: src/multiset.c:1.32

5:   \*/   /**/   #include "global.h" - RCSID("$Id: builtin_functions.c,v 1.333 2001/01/19 13:53:43 mirar Exp $"); + RCSID("$Id: builtin_functions.c,v 1.334 2001/01/31 13:27:49 grubba Exp $");   #include "interpret.h"   #include "svalue.h"   #include "pike_macros.h"
108:    push_array(a); /* beware, macro */   }    + /*! @decl int compat_hash(string s) +  *! @decl int compat_hash(string s, int max) +  *! +  *! This function will return an @tt{int@} derived from the string @[s]. +  *! The same string will always hash to the same value. +  *! If @[max] is given, the result will be >= 0 and <= @[max]. +  *! +  *! @note +  *! This function is provided for backward compatibility reasons. +  *! +  *! @seealso +  *! @[hash()] +  */   void f_compat_hash( INT32 args )   {    struct pike_string *s = Pike_sp[-args].u.string;
138:    push_int( i );   }    + /*! @decl int hash(string s) +  *! @decl int hash(string s, int max) +  *! +  *! This function will return an @tt{int@} derived from the string @[s]. +  *! The same string will always hash to the same value. +  *! If @[max] is given, the result will be >= 0 and <= @[max]. +  *! +  *! @note +  *! The hash algorithm was changed in Pike 7.1. If you want a hash +  *! that is compatible with Pike 7.0 and earlier, use @[compat_hash()]. +  *! +  *! @seealso +  *! @[compat_hash()] +  */   void f_hash(INT32 args)   {    size_t i = 0;