Files
calc/help/hash
Landon Curt Noll ab95e47c0a fix and improve trigonometric help files
The trigonometric file files have had several bug fixed.

The EXAMPLE sections of trigonometric file have
been made consistent.

Added these new help files in anticipation of
the code for these new (i.e., to be written) builtin functions:

    hacovercos hacoversin havercos haversin
    ahacovercos ahacoversin ahavercos ahaversin
2023-09-24 12:52:14 -07:00

71 lines
2.1 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) 2023 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.
##
## Under source code control: 2023/09/24 11:12:16
## File existed as early as: 2023
##
## chongo <was here> /\oo/\ http://www.isthe.com/chongo/
## Share and enjoy! :-) http://www.isthe.com/chongo/tech/comp/calc/