105 lines
1.4 KiB
Markdown
105 lines
1.4 KiB
Markdown
# Claro Quick Start Guide
|
|
|
|
Programming Made Simple
|
|
|
|
## What is Claro?
|
|
|
|
Claro is a small scripting language designed for beginners. It uses readable commands like `SAY`, `ASK`, `SET`, and `TEACH`.
|
|
|
|
## 1. Show a message
|
|
|
|
```claro
|
|
SAY "Hello!"
|
|
```
|
|
|
|
Run it:
|
|
|
|
```bash
|
|
./claro hello.claro
|
|
```
|
|
|
|
## 2. Ask a question
|
|
|
|
```claro
|
|
ASK "What is your name?" AS name
|
|
SAY "Hello " + name
|
|
```
|
|
|
|
## 3. Remember information
|
|
|
|
```claro
|
|
SET score TO 10
|
|
SAY score
|
|
```
|
|
|
|
## 4. Make a choice
|
|
|
|
```claro
|
|
IF score >= 5
|
|
SAY "Good job!"
|
|
ELSE
|
|
SAY "Try again."
|
|
ENDIF
|
|
```
|
|
|
|
## 5. Repeat something
|
|
|
|
```claro
|
|
DO 3 TIMES
|
|
SAY "Practice"
|
|
DONE
|
|
```
|
|
|
|
## 6. Use a list
|
|
|
|
```claro
|
|
SET items TO LIST
|
|
ADD "milk" TO items
|
|
ADD "bread" TO items
|
|
|
|
FOR EACH item IN items
|
|
SAY item
|
|
DONE
|
|
```
|
|
|
|
## 7. Teach a function
|
|
|
|
```claro
|
|
TEACH greet TAKES name
|
|
RETURN "Hello " + name
|
|
LEARNED
|
|
|
|
CALL greet WITH "Alex"
|
|
SAY RESULT
|
|
```
|
|
|
|
## 8. Save a file
|
|
|
|
```claro
|
|
WRITE FILE "note.txt" WITH "Hello from Claro"
|
|
READ FILE "note.txt" AS note
|
|
SAY note
|
|
```
|
|
|
|
## Good first project: a quiz
|
|
|
|
```claro
|
|
SAY "Tiny Quiz"
|
|
ASK "What is 2 + 2?" AS answer
|
|
|
|
IF answer = 4
|
|
SAY "Correct!"
|
|
ELSE
|
|
SAY "The answer is 4."
|
|
ENDIF
|
|
```
|
|
|
|
## Tips
|
|
|
|
- Use `SAY` to show information.
|
|
- Use `ASK` to get information.
|
|
- Use `SET` to remember information.
|
|
- Use `IF` when the program needs to choose.
|
|
- Use `DO` or `FOR` when something repeats.
|
|
- Use `TEACH` to make reusable code.
|