^ (base exponent -- power)

Inputs

• base: Real base value.
• exponent: Real exponent value.

Outputs

• power: Power object in the same real schema.

^ accepts only same-schema Real32 or Real64 operands. Both inputs are dereferenced and must be non-NIL.

Behavior

• If both operands are known at compile time, the result is computed at compile time.
• If base is known 1 and exponent is unknown, the result is known 1 of the same real schema.
• If exponent is known 0 and base is unknown, the result is known 1 of the same real schema.
• If exponent is known 1 and base is unknown, the result is an unknown value of the same real schema.
• In all other cases with an unknown operand, the result is an unknown value of the same real schema.
• Known values follow real exponentiation semantics, including results such as nan when the real operation does not produce a finite number.

Example

{} () {} [
  "-- real32 --" printCompilerMessage
  2.0r32 3.0r32 ^ printStack _:;
  2.0r32 -1.0r32 ^ printStack _:;
  -1.0r32 0.5r32 ^ printStack _:;

  "-- known base or exponent --" printCompilerMessage
  unknownExponent: 0.0r32 dynamic;
  1.0r32 unknownExponent ^ printStack _:;

  unknownBase: 0.0r32 dynamic;
  unknownBase 0.0r32 ^ printStack _:;
  unknownBase 1.0r32 ^ printStack _:;
] "main" exportFunction

Expected Output During Compilation

-- real32 --
8.0r32
0.5r32
nanr32
-- known base or exponent --
1.0r32
1.0r32
Real32

See also

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