mirror of
https://github.com/lcn2/calc.git
synced 2025-08-16 01:03:29 +03:00
75 lines
2.3 KiB
Plaintext
75 lines
2.3 KiB
Plaintext
NAME
|
|
hash - return the calc hash value
|
|
|
|
SYNOPSIS
|
|
hash(x_1 [, x_2, x_3, ...])
|
|
|
|
TYPES
|
|
x_1, x_1, ... any
|
|
|
|
return integer v, 0 <= v < 2^32
|
|
|
|
DESCRIPTION
|
|
Returns a hash value for one or more values of arbitrary types.
|
|
|
|
The calc hash value is based on the core Fowler/Noll/Vo hash
|
|
known as FNV-0. The return value, however, cannot be used
|
|
as an FNV hash value because calc's internal function also
|
|
takes into account more abstract concepts such as data types.
|
|
|
|
WARNING: Use of FNV-0 is NOT recommended for general purposes.
|
|
Calc uses FNV-0 for internal objects such as associative
|
|
arrays as well as other internal processes. Calc
|
|
maintains the use of FNV-0 for backwards compatibility.
|
|
|
|
You should use the FNV-1a hash instead!!!!!
|
|
|
|
Use the fnv() builtin function for general quick, non-cryptographic
|
|
hash purposes.
|
|
|
|
See also:
|
|
|
|
http://www.isthe.com/chongo/tech/comp/fnv/
|
|
|
|
information about the Fowler/Noll/Vo (FNV) hash.
|
|
|
|
EXAMPLE
|
|
; a = isqrt(2e1000); s = "xyz";
|
|
; hash(a,s)
|
|
2378490456
|
|
|
|
LIMITS
|
|
The number of arguments is not to exceed 1024.
|
|
|
|
LINK LIBRARY
|
|
none
|
|
|
|
SEE ALSO
|
|
ishash, fnv, sha1
|
|
|
|
## Copyright (C) 1999-2007,2014 Landon Curt Noll
|
|
##
|
|
## Calc is open software; you can redistribute it and/or modify it under
|
|
## the terms of the version 2.1 of the GNU Lesser General Public License
|
|
## as published by the Free Software Foundation.
|
|
##
|
|
## Calc is distributed in the hope that it will be useful, but WITHOUT
|
|
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|
|
## or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
|
|
## Public License for more details.
|
|
##
|
|
## A copy of version 2.1 of the GNU Lesser General Public License is
|
|
## distributed with calc under the filename COPYING-LGPL. You should have
|
|
## received a copy with calc; if not, write to Free Software Foundation, Inc.
|
|
## 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
##
|
|
## @(#) $Revision: 30.3 $
|
|
## @(#) $Id: hash,v 30.3 2014/10/06 08:45:56 chongo Exp $
|
|
## @(#) $Source: /usr/local/src/bin/calc/help/RCS/hash,v $
|
|
##
|
|
## Under source code control: 1996/03/12 23:10:01
|
|
## File existed as early as: 1996
|
|
##
|
|
## chongo <was here> /\oo/\ http://www.isthe.com/chongo/
|
|
## Share and enjoy! :-) http://www.isthe.com/chongo/tech/comp/calc/
|