operators.md

Operators

Binary Operators

Standard C# binary operators are emitted directly. All binary expressions are explicitly parenthesized because Lua operator precedence differs from C#.

int result = (a + b) * c;
bool eq = x == y;
bool gt = x > y;

local result = ((a + b) * c)
local eq = (x == y)
local gt = (x > y)

Supported: +, -, *, /, %, ==, !=, <, <=, >, >=, &&, ||, &, |, ^, <<, >>.

!= lowers to ~= in Lua. && lowers to and, || lowers to or.

User-defined operator overloads lower to static Lua functions. When multiple overloads share the same operator name, SharpForge appends the same simplified parameter-signature suffix used for overloaded methods.

public static Vector3 operator *(Vector3 v, float f) => new(v.x * f, v.y * f, v.z * f);
public static Vector3 operator *(float f, Vector3 v) => new(v.x * f, v.y * f, v.z * f);

function SF__.Vector3.op_Multiply__vector3f(v__x, v__y, v__z, f)
	return (v__x * f), (v__y * f), (v__z * f)
end

function SF__.Vector3.op_Multiply__fvector3(f, v__x, v__y, v__z)
	return (v__x * f), (v__y * f), (v__z * f)
end

Unary Operators

bool b = !flag;
int n = -x;

local b = (not flag)
local n = (-x)

Compound Assignment

+=, -=, *=, /=, %= lower to expanded assignment:

count += 1;

count = (count + 1)

String += lowers through the nil-safe concatenation helper and flattens nested string + expressions:

text += "\n" + inspectorText;

text = SF__.StrConcat__(text, "\n", inspectorText)

??= lowers to a nil check. As a statement, the right-hand side is assigned only when the target is nil:

cached ??= CreateValue();

if cached == nil then
	cached = SF__.CreateValue()
end

When ??= is used as an expression, SharpForge emits an immediately invoked function that returns the existing non-nil value or assigns and returns the new value.

String Concatenation

The + operator on strings lowers to the nil-safe SF__.StrConcat__(...) helper. See strings.md.

Unsupported Operators

??, ?[], bitwise assignment (&=, |=, ^=, <<=, >>=), and checked arithmetic produce a transpiler error.