Dino compiler: language, formatter, language server, docs, editor support
Compiler in Rust (lexer, parser, checker, C codegen), maps, chars, dino fmt, dino lsp (diagnostics, formatting, outline, definition, hover, completion, signature help), docs, examples, VS Code/Vim files. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
3e2779f447
commit
eaf9567a36
117 files changed
+19970
No files matched your search
@@ -0,0 +1,123 @@
|
||||
# 10. Files and the standard library
|
||||
|
||||
## Splitting a program into files
|
||||
|
||||
`import utils` brings in the file `utils.dino` that sits next to your main file. Use its
|
||||
contents with the module name in front. Only things marked `pub` can be used from outside.
|
||||
|
||||
`utils.dino`:
|
||||
|
||||
```dino
|
||||
pub const SCALE = 10
|
||||
|
||||
pub struct Vec2 {
|
||||
pub x, y: float
|
||||
pub func scaled(k: float): Vec2 { return Vec2{x * k, y * k} }
|
||||
}
|
||||
|
||||
pub func double(n: int): int { return n * 2 }
|
||||
|
||||
func secret() {} // private: only this file can call it
|
||||
```
|
||||
|
||||
`main.dino`:
|
||||
|
||||
```dino
|
||||
import utils
|
||||
|
||||
func main() {
|
||||
print(utils.double(4), utils.SCALE)
|
||||
var v = utils.Vec2{1.0, 2.0}
|
||||
print(v.scaled(3.0))
|
||||
}
|
||||
```
|
||||
|
||||
- Folders work too: `import tools.fs` is the file `tools/fs.dino`, used as `fs.name`.
|
||||
- Fields are private as well unless written `pub x: int`.
|
||||
- Every file has its own names, so two files can both define `helper`.
|
||||
- Import loops and missing files are errors. An error message names the file it is in.
|
||||
|
||||
## Built-in modules
|
||||
|
||||
Import them like your own files: `import os`.
|
||||
|
||||
### os
|
||||
|
||||
| | |
|
||||
|--|--|
|
||||
| `os.args` | list of command-line words (`args[0]` is the program) |
|
||||
| `os.read_file(path)` | `(string, error)` |
|
||||
| `os.write_file(path, text)` | `error` |
|
||||
| `os.append_file(path, text)` | `error` |
|
||||
| `os.exists(path)` | `bool` |
|
||||
| `os.read_line()` | next line typed on the keyboard, or `nil` at the end |
|
||||
| `os.env(name)` | the environment variable, or `nil` |
|
||||
| `os.exit(code)` | stop the program |
|
||||
|
||||
### math
|
||||
|
||||
`sqrt pow floor ceil round trunc sin cos tan asin acos atan atan2 exp log log10 hypot
|
||||
min max abs`, and the values `PI` and `E`.
|
||||
|
||||
```dino
|
||||
import math
|
||||
|
||||
func main() {
|
||||
print(math.sqrt(16), math.pow(2, 10), math.max(3, 9), math.PI)
|
||||
}
|
||||
```
|
||||
```text
|
||||
4.0 1024.0 9 3.14159265358979
|
||||
```
|
||||
|
||||
### time
|
||||
|
||||
`time.now()` gives seconds as a float. `time.sleep(seconds)` waits.
|
||||
|
||||
### Strings
|
||||
|
||||
`upper lower trim split lines fields replace repeat contains starts_with ends_with
|
||||
index_of to_int to_float`, plus `len()` and slicing.
|
||||
|
||||
```dino
|
||||
func main() {
|
||||
var csv = " a, b ,c "
|
||||
for part in csv.split(",") {
|
||||
print("[" + part.trim() + "]")
|
||||
}
|
||||
print("x".repeat(3), "Hello".lower(), "a-b".replace("-", "+"))
|
||||
print("hello".index_of("l"), "hello".index_of("z"))
|
||||
}
|
||||
```
|
||||
```text
|
||||
[a]
|
||||
[b]
|
||||
[c]
|
||||
xxx hello a+b
|
||||
2 -1
|
||||
```
|
||||
|
||||
A list of strings can be joined: `["a", "b"].join("-")`.
|
||||
|
||||
## A program that reads input
|
||||
|
||||
```dino
|
||||
import os
|
||||
|
||||
func main() {
|
||||
var total = 0
|
||||
for {
|
||||
var line = os.read_line()
|
||||
if line == nil { break }
|
||||
var n, err = line.trim().to_int()
|
||||
if err != nil {
|
||||
print("skipping:", line)
|
||||
continue
|
||||
}
|
||||
total += n
|
||||
}
|
||||
print("total", total)
|
||||
}
|
||||
```
|
||||
|
||||
Next: [Cheatsheet](11-cheatsheet.md)
|
||||
Reference in new issue
Block a user