^ : Power (Exponentiation) Operator
On this page
Summary
Raise a number to a specified power (exponentiation).
Syntax
Precedence
Priority level in expression evaluation (1 = highest, 10 = lowest): 3
Evaluated after: (), .
Evaluated before: *, /, %, +, -, comparison, equality, ??, &&, ||
Operands
| Position | Type | Description |
|---|---|---|
| Left | Number | Base value |
| Right | Number | Exponent (power to raise to) |
Returns
Type: Double
The base raised to the power of the exponent.
Examples
Square
Data:
doc.Params["model"] = new {
side = 5
};
Output:
<p>Area of square: 25 sq ft</p>
Cube
Data:
doc.Params["model"] = new {
side = 3
};
Output:
<p>Volume of cube: 27 cubic ft</p>
Compound Interest
Data:
doc.Params["model"] = new {
principal = 1000m,
rate = 0.05,
years = 10
};
Output:
<p>Future Value: $1628.89</p>
Scientific Notation
Power of 10
Data:
doc.Params["model"] = new {
value = 1.5,
decimals = 3
};
Output:
<p>1500</p>
Notes
- Highest precedence among arithmetic operators
- Result is always a double-precision floating point number
- Use
pow(base, exponent)function for same functionality - For square root, use
sqrt()function orvalue ^ 0.5 - Negative exponents calculate reciprocal (1/x^n)
- Fractional exponents calculate roots (x^(1/n) = nth root)
- Cannot use with non-numeric types
Common Powers
| Expression | Description | Example |
|---|---|---|
x ^ 2 |
Square | 5 ^ 2 = 25 |
x ^ 3 |
Cube | 3 ^ 3 = 27 |
x ^ 0.5 |
Square root | 16 ^ 0.5 = 4 |
x ^ -1 |
Reciprocal | 2 ^ -1 = 0.5 |
10 ^ n |
Power of 10 | 10 ^ 3 = 1000 |