Home > CBM > BASIC > Keywords > Sgn
180 Subpages: (divide), (equal), (less), (minus), (more), (multiply), (plus), (power), Abs, And, Append, Asc, Atn, Auto, Backup, Bank, Begin, Bend, Bload, Boot, Box, Bsave, Bump, Catalog, Char, Chr, Circle, Close, Clr, Cmd, Collect, Collision, Color, Concat, Cont, Copy, Cos, Data, Dclear, Dclose, Dec, Def, Delete, Dim, Directory, Dispose, Dload, Do, Dopen, Draw, Ds, Ds string, Dsave, Dverify, El, Else, End, Envelope, Er, Err, Exit, Exp, Fast, Fetch, Filter, Fn, For, Fre, Get, Get num, Getkey, Go, Gosub, Goto, Graphic, Gshape, Header, Help, Hex, If, Input, Input num, Instr, Int, Joy, Key, Left, Len, Let, List, Load, Locate, Log, Loop, Mid, Monitor, Movspr, New, Next, Not, Off, On, Open, Or, Paint, Peek, Pen, Pi, Play, Pointer, Poke, Pos, Pot, Print, Print num, Pudef, Quit, Rclr, Rdot, Read, Record, Rem, Rename, Renumber, Restore, Resume, Return, Rgr, Right, Rlum, Rnd, Rreg, Rspcolor, Rsppos, Rsprite, Run, Rwindow, Save, Scale, Scnclr, Scratch, Sin, Sleep, Slow, Sound, Spc, Sprcolor, Sprdef, Sprite, Sprsav, Sqr, Sshape, St, Stash, Step, Stop, Str, Swap, Sys, Tab, Tan, Tempo, Then, Ti, Ti string, To, Trap, Troff, Tron, Until, Using, Usr, Val, Verify, Vol, Wait, While, Width, Window, Xor |
| Keyword | Abbreviation | Token (hex) | Version(s) | Classification |
| SGN | S{Shift+G} | B4 | 1.0+ | Function |
SGN( value )
| Parameters | Type | Legal Value(s) | Default Value | Note(s) |
| value | Numeric | any | | |
| Returns | Type | Value(s) | Note(s) |
| result | Floating-point | -1, 0, +1 | |
Calculate the arithmetic sign of a number.
The SGN function simply returns a result telling if the original value was positive
( result = +1), negative ( result = -1), or nuetral ( result = 0);
in particular it discards the magnitude of the original value.
This is useful because multiplying (a presumably different value) by +1 or -1 won't change the magnitude,
only (possibly) the sign. Useful for polar to rectangular conversion (among other things).
Not to be confused with the triginometric sine, which is quite different!
You will get TYPE MISMATCH ERROR with a string value.
(less), (more)
ABS, SIN
ATN, SQR
© H2Obsession, 2014 |