1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
# Functions and operator overloads
Part of the [subsystem notes](../SUBSYSTEMS.md). See also [EXTERN "C"](EXTERN.md) and
[templates](TEMPLATES.md).
## Functions (`FunctionGen`)
Plain LLVM functions, external linkage, exact pseudocode name unless OVERLOAD appends a
canonical parameter list and, for non-VOID results, a `:ReturnKey` suffix (MAIN uses
internal __cps_main).
### Parameters and bodies
- Params are `ParamDecl{name, typeString, mode, array rank/bounds}`.
- BYVAL args are copied into entry-block allocas (whole structs for records); BYREF args
bind the incoming pointer directly as the variable's storage.
- Array params are handed to the binder callback CodeGen injects
(`setArrayParamBinder`) so FunctionGen never sees ArrayHandler.
- Missing RETURNS defaults the return type to INTEGER; procedures use "VOID".
- Body emission is inverted: CodeGen injects a `StmtEmitter` callback, and must restore
its own insert point (and the exchanged ArrayTable) afterwards.
- Functions inherit visible GLOBAL storage and previously declared own top-level
CONSTANT values, plus imported constants from the start; local constants use the same
Symbols table with lexical binding restoration.
### Signatures and call resolution
- `emitPrototype` records each function's pseudocode signature in a `FuncSig`
overload-set map (`FunctionGen::getOverloads`, filtered by unit visibility).
- `resolveCall` selects exact static parameter types/ranks for OVERLOAD. When the call
site has an expected result type, the candidate must also return exactly that type;
a cast only prefers it. Without a context, return-only-distinct candidates use
the unique DEFAULT return, otherwise they are ambiguous. A single ordinary definition keeps implicit conversions.
- `RETURNS DEFAULT type` records IsDefaultReturn on PrototypeAST and FuncSig.
Only non-VOID OVERLOAD functions support it; templates reject it. Registration
rejects two defaults for one name and ParamKey across all input units.
FunctionGen::selectDefaultReturn is shared by call and operator resolution; it
only resolves candidates with the same name and ParamKey, preserving parameter
ambiguity and global/member ties. Defaults do not affect link names.
- Parameter keys exclude return types, modes and bounds; the separate ReturnKey holds
the declared result (PROCEDURE is VOID). Equivalent C aliases use CIdentity.
Duplicate signatures require both keys to match, even across invisible units.
- CodeGen records result contexts per expression node before the first type query
(`expectResult`/`resultContext`); assignment, BYVAL/RETURN, coercion and cast sites
register them, and call/operator selection consults the same table for typing and
emission.
- FunctionGen tracks prototype registration separately from source names and indexes
signatures by LLVM link name for RETURN (`getSignatureByLink`). A non-VOID
OVERLOAD link name appends `:ReturnKey` after `Name(ParamKey)`; PROCEDURE, NEW and
OPERATOR<- keep their old names.
- `CodeGen::marshalCallArgs` consumes the selected FuncSig, and `getExprTypeInfo`
resolves the same calls without emitting IR.
- Prototype pre-registration (calls may precede definitions): see
[CONVENTIONS/CALLS.md](../CONVENTIONS/CALLS.md).
## Operator overloads (`OperatorGen.cc`)
- PrototypeAST retains the operator token; FunctionGen validates operand count and
requires a record/class/enum operand.
- Global signatures and left-class methods share exact-type selection, used by
ValueTypeGen and ExpressionGen before builtin operations and filtered by an expected
result type where present. A strict context whose operands match but whose result does
not sets `WrongResult`. Missing candidates leave builtin rules intact; ties are
errors. Member access is checked after selection.
- The raw-expression argument-marshalling overload borrows AST pointers for operator
calls; ordinary calls adapt their unique_ptr lists into it.
- Member receivers use lvalue storage or a materialized, Alive-tracked temporary.
- CASE calls the value entry point with its already captured selector and requires
BOOLEAN results.
|
