基本

Warning: 本文檔不完整。它未經校對(樣式、正確鏈接、誤譯等)。此外，Erg 的語法可能在版本 0.* 期間發生破壞性更改，并且文檔可能沒有相應更新。請事先了解這一點如果您在本文檔中發現任何錯誤，請報告至此處的表單或 GitHub repo。我們將不勝感激您的建議

本文檔描述 Erg 的基本語法如果您已經有使用 Python 等語言的經驗，請參閱快速瀏覽了解概覽還有一個單獨的標準 API 和 Erg 貢獻者的內部文檔。如果您需要語法或 Erg 本身的詳細說明, 請參閱那些文檔

你好，世界!

首先，讓我們做"Hello World"


print!("Hello, World!")

這與 Python 和同一家族中的其他語言幾乎相同。最顯著的Trait是!，后面會解釋它的含義在 Erg 中，括號 () 可以省略，除非在解釋上有一些混淆括號的省略與 Ruby 類似，但不能省略可以以多種方式解釋的括號


print! "Hello, World!" # OK
print! "Hello,", "World!" # OK
print!() # OK
print! # OK, 但這并不意味著調用，只是將 `print!` 作為可調用對象

print! f x # OK, 解釋為 `print!(f(x))`
print!(f(x, y)) # OK
print! f(x, y) # OK
print! f(x, g y) # OK
print! f x, y # NG, 可以理解為 `print!(f(x), y)` 或 `print!(f(x, y))`
print!(f x, y) # NG, 可以表示"print！(f(x)，y)"或"print！(f(x，y))"
print! f(x, g y, z) # NG, 可以表示"print！(x，g(y)，z)"或"print！(x，g(y，z))"

腳本

Erg 代碼稱為腳本。腳本可以以文件格式 (.er) 保存和執行

REPL/文件執行

要啟動 REPL，只需鍵入:


> erg

> mark is a prompt, just type erg. Then the REPL should start.


> erg
Starting the REPL server...
Connecting to the REPL server...
Erg interpreter 0.2.4 (tags/?:, 2022/08/17  0:55:12.95) on x86_64/windows
>>>

Or you can compile from a file.


> 'print! "hello, world!"' >> hello.er

> erg hello.er
hello, world!

注釋

# 之后的代碼作為注釋被忽略。使用它來解釋代碼的意圖或暫時禁用代碼


# Comment
# `#` and after are ignored until a new line is inserted
#[
Multi-line comment
Treated as a comment all the way up to the corresponding `]#`
]#

文檔注釋

'''...'''是一個文檔注釋。注意，與Python不同，它是在任何類或函數之外定義的。


'''
PI is a constant that is the ratio of the circumference of a circle to its diameter.
'''
PI = 3.141592653589793
'''
This function returns twice the given number.
'''
twice x = x * 2

print! twice.__doc__
# This function returns twice the given number.

'''
Documentation comments for the entire class
'''
C = Class {x = Int}
    '''
    Method documentation comments
    '''
    .method self = ...

您可以通過在'''之后立即寫入語言代碼來指定文檔的語言。然后，Erg語言服務器將以Markdown格式顯示每種語言版本的文檔(默認語言為英語)。參見這里獲取多語言相關文檔


'''
Answer to the Ultimate Question of Life, the Universe, and Everything.
cf. https://www.google.co.jp/search?q=answer+to+life+the+universe+and+everything
'''
'''japanese
生命、宇宙、そして全てについての究極の謎への答え
參照: https://www.google.co.jp/search?q=answer+to+life+the+universe+and+everything
'''
ANSWER = 42

表達式，分隔符

腳本是一系列表達式。表達式是可以計算或評估的東西，在 Erg 中幾乎所有東西都是表達式每個表達式由分隔符分隔 - 新行或分號 ;- Erg 腳本基本上是從左到右、從上到下進行評估的


n = 1 # 賦值表達式
f(1, 2) # 函數調用表達式
1 + 1 # 運算符調用表達式
f(1, 2); 1 + 1

如下所示，有一種稱為 Instant block 的語法，它將塊中評估的最后一個表達式作為變量的值這與沒有參數的函數不同，它不添加 ()。請注意，即時塊僅在運行中評估一次


i =
    x = 1
    x + 1
assert i == 2

這不能用分號 (;) 完成


i = (x = 1; x + 1) # 語法錯誤: 不能在括號中使用 `;`

縮進

Erg 和 Python 一樣，使用縮進來表示塊。有三個運算符(特殊形式)觸發塊的開始: =、-> 和 =>(此外，: 和 | ，雖然不是運算符，但也會產生縮進)。每個的含義將在后面描述


f x, y =
    x + y

for! 0..9, i =>
    print!

for! 0..9, i =>
    print! i; print! i

ans = match x:
    0 -> "zero"
    _: 0..9 -> "1 dight"
    _: 10..99 -> "2 dights"
    _ -> "unknown"

如果一行太長，可以使用 \ 將其斷開


# 這不是表示 `x + y + z` 而是表示 `x; +y; +z`
X
+ y
+ z

# 這意味著`x + y + z`
x \
+ y \
+ z

The Erg Book