cos (angle -- cosine)

Inputs

• angle: Real angle in radians.

Outputs

• cosine: Cosine in the same real schema.

cos accepts Real32 and Real64 values. The input is dereferenced and must be non-NIL. The input value represents an angle in radians.

Behavior

• A known input is evaluated at compile time.
• An unknown input produces an unknown value of the same real schema.
• The result keeps the same real schema as the input.
• Representative known cases include zero mapping to one and π mapping to minus one in the corresponding real schema.

Example

{} () {} [
  "-- real32 --" printCompilerMessage
  0.0r32 cos printStack _:;
  3.1415927r32 cos printStack _:;

  "-- real64 --" printCompilerMessage
  0.0 cos printStack _:;
  3.141592653589793 cos printStack _:;
] "main" exportFunction

Expected Output During Compilation

-- real32 --
1.0r32
-1.0r32
-- real64 --
1.0
-1.0

See also

• ^ builtin (base exponent -- power) Raises one Real value to another of the same schema and keeps that real schema in the result.
• cast builtin (value schema -- convertedValue) Casts a Cond or numeric value to the numeric schema selected by the schema input.
• ceil builtin (value -- ceilingValue) Rounds a Real value upward and keeps the same real schema.
• floor builtin (value -- floorValue) Rounds a Real value downward and keeps the same real schema.
• log builtin (argument -- naturalLogarithm) Computes the natural logarithm of a Real value and keeps the same real schema.
• log10 builtin (argument -- decimalLogarithm) Computes the base-10 logarithm of a Real value and keeps the same real schema.
• neg builtin (value -- negatedValue) Negates a signed Int or Real value and keeps the same schema.
• sin builtin (angle -- sine) Computes the sine of a Real value and keeps the same real schema.
• sqrt builtin (radicand -- squareRoot) Computes the square root of a Real value and keeps the same real schema.