基本構文¶

このガイドでは、Onionプログラミング言語の基本的な構文要素を説明します。

コメント¶

Onionは現在、C言語スタイルのコメントをサポートしています：

// 単一行コメント

/*
 * 複数行コメント
 * 複数行にまたがります
 */

変数¶

変数宣言¶

変数はval（不変）またはvar（可変）で宣言します。ローカル宣言では初期化子がある場合、型を省略できます：

val name = "Alice"
var count = 0
val age: Int = 30
val price: Double = 19.99
val isActive: Boolean = true

代入は既存の変数を更新するだけで、新しい変数を宣言するわけではありません。

命名規則¶

変数名はキャメルケース: firstName, totalCount
クラス名はパスカルケース: Person, Calculator
フィールドはthis.fieldでアクセス

プリミティブ型¶

Onionは標準的なJVMプリミティブ型をサポートします：

型	説明	例
`Int`	32ビット整数	`42`
`Long`	64ビット整数	`42L`
`Double`	64ビット浮動小数点	`3.14`
`Float`	32ビット浮動小数点	`3.14f`
`Boolean`	true または false	`true`, `false`
`Char`	単一文字	`'A'`
`Byte`	8ビット整数	`127`
`Short`	16ビット整数	`1000`

リテラル¶

文字列リテラル¶

val greeting: String = "Hello, World!"
val multiline: String = "Line 1\nLine 2\nLine 3"
val withQuotes: String = "She said \"Hello\""

数値リテラル¶

val decimal: Int = 42
val hex: Int = 0xFF
val binary: Int = 0b1010
val octal: Int = 077
val longValue: Long = 100L
val byteValue: Byte = 5B
val shortValue: Short = 5S
val doubleValue: Double = 3.14
val floatValue: Float = 3.14f      // f/F で Float、d/D で Double（大文字・小文字どちらも可）
val scientific: Double = 1.23e10

アンダースコアはどの数値リテラルでも桁区切りに使えます：

val million = 1_000_000
val mask = 0xFF_FF
val flags = 0b1010_1010
val precise = 1_234.5

文字リテラル¶

val letter: Char = 'A'
val newline: Char = '\n'
val tab: Char = '\t'

真偽値リテラル¶

val isTrue: Boolean = true
val isFalse: Boolean = false

nullリテラル¶

val nullable: String? = null   // nullにはnullable型が必要（そうしないとW0012）

演算子¶

算術演算子¶

val a: Int = 10
val b: Int = 3

val sum: Int = a + b        // 13
val diff: Int = a - b       // 7
val product: Int = a * b    // 30
val quotient: Int = a / b   // 3
val remainder: Int = a % b  // 1

比較演算子¶

val x: Int = 5
val y: Int = 10

x == y  // false（等しい）
x != y  // true（等しくない）
x < y   // true（より小さい）
x > y   // false（より大きい）
x <= y  // true（以下）
x >= y  // false（以上）

論理演算子¶

val a: Boolean = true
val b: Boolean = false

a && b  // false（論理積）
a || b  // true（論理和）
!a      // false（論理否定）

代入演算子¶

var x: Int = 10

x = 20       // 単純代入
x = x + 5    // 加算して代入（+= 構文はまだ無い）
x = x - 3    // 減算して代入
x = x * 2    // 乗算して代入

インクリメント/デクリメント¶

var count: Int = 0
count = count + 1  // インクリメント
// または後置インクリメントを使う（文脈による）
count++
count--

型キャスト演算子¶

asキーワードで型キャストを行います。メソッドチェインの場合は括弧が必要です：

val x: Double = 3.14
val y: Int = x as Int  // Intにキャスト (3)

val random: Double = Math::random()
val randomInt: Int = (random * 100) as Int

// メソッドチェインの場合は括弧が必要
val btn: Object = getButton()
val text: String = (btn as JButton).getText()

リスト追加演算子¶

<<演算子でリストに追加します：

import { java.util.ArrayList; }

val list: ArrayList[String] = new ArrayList[String]()
list << "最初"
list << "2番目"
list << "3番目"

リストとマップ¶

リストは角括弧で書きます。標準ライブラリはリストを受け取り・返すので、普段使うのはほとんどこちらです。配列ではありません。

val colors = ["赤", "緑", "青"]
val scores = [95.5, 87.3, 91.0]
val empty: List[String] = []          // 推論の手がかりが無いときは型を書く

要素の読み書きは []、要素数は .size です。

val first = colors[0]      // "赤"
val n = colors.size        // 3

マップリテラルはキーと値を対にします。

val ages = ["alice": 30, "bob": 25]
val lookup = ages["alice"]            // 30
val nothing: Map[String, Int] = [:]   // 空のマップ

リストにはパイプラインが組み込まれているので、添字を使う場面はほとんどありません。

val odds = [1, 2, 3, 4, 5].filter { n => n % 2 == 1 }   // [1, 3, 5]
val tens = odds.map { n => n * 10 }                     // [10, 30, 50]

全体はコレクションを参照してください。

配列¶

配列もありますが、必要になるのは Java と話すときだけです。main(args: String[])、バイナリ I/O の byte[]、可変長引数がその典型です。

val buffer: String[] = new String[3]
buffer[0] = "a"
val length: Int = buffer.length   // 配列は .size ではなく .length

パイプラインを使いたくなったら Colls::toList(args) でリストに渡せます。

式¶

算術式¶

val result: Int = (10 + 5) * 2 - 3  // 27
val average: Double = (10 + 20 + 30) / 3.0

文字列連結¶

val firstName: String = "Alice"
val lastName: String = "Smith"
val fullName: String = firstName + " " + lastName

val age: Int = 30
val message: String = "I am " + age + " years old"

メソッド呼び出し¶

// 静的メソッド呼び出し
println("Hello")

// インスタンスメソッド呼び出し
val text: String = "hello"
val upper: String = text.toUpperCase()
val len: Int = text.length

オブジェクト生成¶

import { java.util.ArrayList; }

val list: ArrayList[String] = new ArrayList[String]()
val array: String[] = new String[10]

ブロック要素¶

ブロック内の式¶

任意の式はブロックの中に直接書けます：

println("Hello")
var x: Int = 10
x = x + 1

ブロック式¶

ブロックは波括弧で囲みます：

{
  val temp: Int = 5
  println(temp)
  // tempはこのブロック内でのみ有効
}

スコープと可視性¶

ローカル変数¶

メソッドやブロック内で宣言された変数は、そのスコープ内でのみ有効：

def method {
  val local: Int = 10
  // localはここでのみ有効
}

フィールド¶

フィールドはval/varで宣言し、this.fieldでアクセス：

class Example {
  var count: Int
  val name: String = "default"

  public:
    def increment {
      this.count = this.count + 1
    }
}

アクセス修飾子¶

デフォルトではメンバーはprivateです。public:で公開メンバーをマーク：

class Person {
  val ssn: String = "000-00-0000"  // デフォルトでprivate

  public:
    val name: String = "Alice"  // public

    def getName: String = this.name  // publicメソッド
}

インターフェース¶

インターフェースは本体を持たないメソッドシグネチャを宣言します。インターフェース全体を1行で書くことができ、本体のないメソッドの直後に閉じ } を同じ行に置くこともできます：

interface Shape { def area(): Double }

class Circle extends Object conforms Shape {
  val r: Double
public:
  def this(r: Double) { this.r = r }
  override def area(): Double = 3.14 * this.r * this.r
}

val s: Shape = new Circle(2.0)
println(s.area())   // 12.56

モジュールシステム¶

Import文¶

JavaクラスをOnionコードで使用するためにインポート。エイリアスも使用可能：

import {
  java.util.ArrayList;
  java.util.HashMap;
  java.io.File;
  java.lang.Long as JLong;
}

val list: ArrayList[String] = new ArrayList[String]()
val map: HashMap[String, String] = new HashMap[String, String]()
val file: File = new File("data.txt")
val str: String = JLong::toString(42L)

完全修飾名¶

インポートなしでも完全修飾名を使用できます：

val list: java.util.ArrayList[String] = new java.util.ArrayList[String]()

次のステップ¶

変数と型 - 型システムを深く掘り下げる
制御フロー - 条件分岐とループ
関数 - 関数定義とラムダ