Files
calc/help/gms2g
Landon Curt Noll f5c5cea8b0 Correct typos
2021-12-05 18:23:27 -08:00

85 lines
2.3 KiB
Plaintext

NAME
gm2g, gms2g - convert gradians, minutes, and seconds to gradians
SYNOPSIS
gm2g(d, m [,rnd])
gms2g(d, m, s [,rnd])
TYPES
d real
m real
s real (default to 0)
rnd nonnegative integer, defaults to config("mod")
return gradians
DESCRIPTION
Convert gradians, m minutes, and s seconds returning gradians.
The return value in gradians, is equivalent to the following:
mod(d + m/60 + s/4000, 400, rnd);
Depending on the rounding mode, the return could be a real value
in the interval [0, 400) or a real value in the interval (-400, 0].
For the default round mode, the return value is in the interval [0, 400).
A missing rnd defaults to config("mod").
For more information on the effects of rnd, see "help mod".
The gm2g(d, m, rnd) builtin is an alias for gms2g(d, m, 0, rnd).
EXAMPLE
; print gm2g(203, 325.5594);
208.42599
; print gm2g(4001, -25.5594);
0.57401
; print gm2g(-923, -25.5594);
276.57401
; print gms2g(12, 20, 44.16);
12.3456
; print gms2g(123.456, -345.68, 4.08);
117.6958
; print gms2g(-65, -40, -44.4);
334.321
; print gm2g(203, 325.5594, 1);
-191.57401
; print gms2g(12, 20, 44.16, 1);
-387.6544
LIMITS
none
LINK LIBRARY
none
SEE ALSO
config, d2dm, d2dms, dm2d, dms2d, g2gm, g2gms, gm2g, gms2g,
h2hm, h2hms, hm2d, hms2d, mod
## Copyright (C) 2021 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: 2021/09/25 17:24:51
## File existed as early as: 2021
##
## chongo <was here> /\oo/\ http://www.isthe.com/chongo/
## Share and enjoy! :-) http://www.isthe.com/chongo/tech/comp/calc/