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
|
% CPSC-KEYWORD-INCLUDE_OBJ(7)
# NAME
cpsc-keyword-include_obj - link a C object file or the C library
# SYNOPSIS
```text
INCLUDE_OBJ "path.o"
INCLUDE_OBJ "__libc"
```
# DESCRIPTION
INCLUDE_OBJ is a compiler extension, allowed only at top level. It names an object file whose functions EXTERN declarations may call. Resolve the path relative to the including source's directory; it must name a `.o` object file built for the same platform, for example with `cc -c lib.c`. The special name `"__libc"` selects the C standard library, including the math library; it must be included explicitly before declaring C library functions.
INCLUDE_OBJ applies to the whole program: objects from every input file are linked together, and repeated objects are linked once. Each EXTERN symbol must be defined by one of them. Native output links the objects, and `-r` loads them for execution. `-S` writes IR only; link any objects yourself when building the IR manually.
# EXAMPLE
`lib.c`, compiled with `cc -c lib.c`:
```text
int add3(int a, int b, int c) { return a + b + c; }
```
`me.cps`:
```text
INCLUDE_OBJ "lib.o"
EXTERN "C" EXTERN_FUNCTION add3(C_INT, C_INT, C_INT) RETURNS C_INT
OUTPUT add3((C_INT)1, (C_INT)2, (C_INT)3)
```
Run with `cpsc me.cps -r` to print `6`.
# SEE ALSO
[cpsc-keyword-extern(7)](cpsc-keyword-extern.7.md), [cpsc-keyword-include(7)](cpsc-keyword-include.7.md), [cpsc(1)](../../cpsc.1.md).
|
