hakorune/docs/quick-reference/syntax-cheatsheet.md

🚀 Nyash構文早見表（Syntax Cheatsheet）

📝 基本構文

変数宣言

local x                    # 変数宣言
local x = 42              # 初期化付き宣言
local a, b, c             # 複数宣言
local x = 10, y = 20, z   # 混合初期化

Box定義（クラス）

box ClassName {
    # フィールド宣言（Phase 12.7形式）
    field1: TypeBox           # デフォルト非公開
    public field2: TypeBox    # 公開フィールド
    private field3: TypeBox   # 明示的非公開
    
    birth(args) {            # コンストラクタ（birth統一）
        me.field1 = args
    }
}

エントリーポイント（優先順）

Nyash はエントリを以下の順で解決します。

1. Main.main があれば優先
2. なければトップレベル main()

両方ある場合は Main.main が使われます。トップレベル main は既定で許可されています（無効化したい場合は NYASH_ENTRY_ALLOW_TOPLEVEL_MAIN=0）。

Static Box（エントリーポイント）

static box Main {
    console: ConsoleBox
    
    main() {
        me.console = new ConsoleBox()
        me.console.log("Hello Nyash!")
        return 0
    }
}

トップレベル main（既定で許可）

main() {
  println("Hello Nyash!")
  return 0
}

プロパティ（stored / computed / once / birth_once）

box MyBox {
  # stored（格納・読み書き可）
  name: StringBox
  id: IntegerBox = 42   # 初期値は生成時に一度だけ評価

  # computed（計算・読み専用）
  greeting: StringBox { return "Hello, " + me.name }

  # once（初回アクセス時に一度だけ計算→以降は保存値）
  once cache: ResultBox { return heavyWork() }

  # birth_once（生成時に一度だけ計算→以降は保存値）
  birth_once token: StringBox { return readEnv("TOKEN") }
}

# 読みは共通、書きは stored のみ可能
local b = new MyBox()
print(b.greeting)   # OK（computed）
b.name = "A"        # OK（stored）
b.greeting = "x"    # エラー（computed には代入不可）

🔄 制御構文

条件分岐

if condition {
    # 処理
} else if condition2 {
    # 処理2
} else {
    # else処理
}

ループ（統一構文）

# ✅ 唯一の正しい形式
loop(condition) {
    if exitCondition {
        break
    }
}

# ❌ 使えない構文
while condition { }  # エラー！
loop() { }          # エラー！

🌟 デリゲーション（継承）

基本デリゲーション

box Child from Parent {
    birth(args) {
        from Parent.birth(args)  # 親のbirth呼び出し
    }
    
    method() {                  # メソッド定義
        from Parent.method()    # 親メソッド呼び出し
    }
}

多重デリゲーション

box Multi from StringBox, IntegerBox {
    # 複数の親から機能を継承
}

⚡ 演算子

算術演算子

a + b    # 加算
a - b    # 減算
a * b    # 乗算
a / b    # 除算（ゼロ除算チェック済）
a % b    # 剰余

論理演算子

not condition    # NOT（推奨）
a and b         # AND（推奨）
a or b          # OR（推奨）

# シンボル版（互換性のため存在するが非推奨）
!condition      # NOT
a && b          # AND
a || b          # OR

比較演算子

a == b    # 等しい
a != b    # 等しくない
a < b     # より小さい
a > b     # より大きい
a <= b    # 以下
a >= b    # 以上

📦 オブジェクト生成

new構文

# 基本形
obj = new ClassName()
obj = new ClassName(arg1, arg2)

# 組み込みBox
console = new ConsoleBox()
array = new ArrayBox()
map = new MapBox()

特殊なコンストラクタ優先順位

box Life {
    birth(name) { }     # 最優先
    pack(args) { }      # ビルトインBox継承用
    init(args) { }      # 通常コンストラクタ
    Life(args) { }      # Box名形式（非推奨）
}

# birthが定義されていればbirthが呼ばれる
obj = new Life("Alice")

🚨 よくある間違い

❌ カンマ忘れ（CPU暴走の原因！）

# ❌ 間違い
init { field1 field2 }    # カンマなし→CPU暴走！

# ✅ 正しい
init { field1, field2 }   # カンマ必須

❌ 未宣言変数

# ❌ 間違い
x = 42    # Runtime Error: 未宣言変数

# ✅ 正しい
local x
x = 42

❌ 計算プロパティへの代入

box B {
  value: IntegerBox { return 1 }  # computed
}

local b = new B()
b.value = 2   # ❌ エラー: 計算プロパティには代入できません（setter を定義するか stored にしてください）

❌ 削除された構文

# ❌ 使えない
while condition { }       # whileは削除済み
super.method()           # superは使えない

# ✅ 代わりに
loop(condition) { }      # loop構文を使う
from Parent.method()     # fromで親を呼ぶ

🎯 実用例

Hello World

static box Main {
    main() {
        print("Hello, Nyash!")
        return 0
    }
}

配列操作

local array
array = new ArrayBox()
array.push(10)
array.push(20)
array.push(30)

local sum = 0
local i = 0
loop(i < array.length()) {
    sum = sum + array.get(i)
    i = i + 1
}
print("Sum: " + sum)  # Sum: 60

エラーハンドリング

try {
    local result = riskyOperation()
} catch (error) {
    print("Error: " + error.message)
} cleanup {
    cleanup()
}

非同期処理

nowait future = longTask()    # 非同期実行
# 他の処理...
local result = await future   # 結果待機

📚 組み込みBox一覧（抜粋）

Box名	用途	主要メソッド
StringBox	文字列	split(), find(), replace(), trim()
IntegerBox	整数	to_string_box()
ArrayBox	配列	push(), pop(), get(), set(), length()
MapBox	辞書	set(), get(), has(), keys()
ConsoleBox	コンソール	log(), error(), read()
MathBox	数学	sin(), cos(), sqrt(), random()
FileBox	ファイル	read(), write(), exists()
JSONBox	JSON	parse(), stringify(), get(), set()

---

Tips:

• すべての値はBox（Everything is Box）
• 変数は必ず宣言してから使う
• ループはloop(condition)のみ
• 親メソッドはfrom Parent.method()で呼ぶ
• カンマ忘れに注意！

ビット演算子（整数限定）

a & b     # ビットAND
a | b     # ビットOR
a ^ b     # ビットXOR
a << n    # 左シフト（n は 0..63 にマスク）
a >> n    # 右シフト（現在は論理シフト相当の実装）

注意: 旧来の >>（ARROW 演算子）は廃止されました。パイプラインは |> を使用してください。