Arbiter スクリプト構文¶

Arbiter スクリプトは、Pipeline と同じ Platypus 言語の構文を使用します。

識別子とキーワード¶

識別子¶

識別子はオブジェクトを識別するために使用され、変数や関数などを表すことができます。識別子にはキーワードが含まれます。カスタム識別子はキーワードと重複してはいけません。

識別子は数字 (0-9)、英字 (A-Z a-z)、アンダースコア (_) で構成されますが、数字で始めることはできず、大文字と小文字が区別されます。例：

• _abc
• abc
• abc1
• abc_1_

識別子を英字またはアンダースコア以外で始める必要がある場合、または特殊文字を含む場合は、バッククォートで囲む必要があります。例：

• 1abc
• @some-variable
• 这是一个表情包变量👍

キーワード¶

キーワードは特別な意味を持つ単語であり、if, elif, else, for, in, break, continue, nil などがあります。これらを変数名、定数名、関数名として使用することはできません。

コメント¶

行コメントには # を使用します。行内コメントはサポートされていません。例：

# これは一行のコメントです
a = 1 # これは一行のコメントです

"""
これは（複数行の）文字列であり、コメントの代わりになります
"""
a = 2

"文字列"
a = 3

組み込みデータ型¶

変数の値は動的に変化する可能性がありますが、各値には明確なデータ型があり、基本型と複合型に分類されます。

基本型¶

整数(int)型¶

整数型は64ビット符号付き整数です。現在は10進数表記のみサポートされています。例：-1, 0, 1, +19。

浮動小数点(float)型¶

浮動小数点型は64ビット符号付き浮動小数点数です。現在は10進数表記のみサポートされています。例：-1.00001, 0.0, 1.0, +19.0。

ブール(bool)型¶

ブール型には true と false の2つの値のみがあります。

文字列(str)型¶

文字列は二重引用符または一重引用符で定義できます。複数行の文字列は三重引用符または三重一重引用符で囲むことができます。例：

• "hello world"
• 'hello world'
• """ を使用した複数行の文字列

"""hello
world"""

• ''' を使用した複数行の文字列

'''
hello
world
'''

複合型¶

複合型には map と list が含まれます。これらは参照型であり、複数の変数が同じオブジェクトを指すことができ、代入時にメモリコピーは行われません。

Map 型¶

map はキーと値のペアの構造です。キーは文字列型のみ、値は任意の型にできます。インデックス式を使用して要素を読み書きします。例：

a = {
  "1": [1, "2", 3, nil],
  "2": 1.1,
  "abc": nil,
  "def": true
}

# a["1"] は list オブジェクトなので、b は a["1"] の値を参照しているだけです
b = a["1"]

"""
この時点で a["1"][0] == 1.1 です
"""
b[0] = 1.1

List 型¶

list には任意の数、任意の型の値を格納できます。インデックス式を使用して要素を読み書きします。例：

a = [1, "2", 3.0, false, nil, {"a": 1}]

a = a[0] # a == 1

演算子¶

Platypus は以下の演算子をサポートしており、優先順位は低いものから高いものの順に示します。

式¶

Platypus はカンマ , を式の区切り文字として使用します。式には値がありますが、文には値がありません。

リテラル式¶

各種データ型のリテラルは式です。例：整数 100, -1, 0、浮動小数点数 1.1、ブール値 true, false など。

複合型のリテラル式は以下の通りです。

• List リテラル式

[1, true, "1", nil]

• Map リテラル式

{
  "a": 1,
  "b": "2",
}

呼び出し式¶

以下は関数呼び出しの例で、リストの要素数を取得します。

len([1, 3, "5"])

二項式¶

二項式は二項演算子と左右のオペランドから構成されます。

現在のバージョンでは、代入式は二項式に含まれ、戻り値を持ちます。ただし、代入式は問題を引き起こす可能性があるため、将来的にこの構文は削除され、代入文の構文が追加される予定です。

# 0
2 / 5

# 0.4。計算時に左オペランドの型が浮動小数点数に昇格されます
2 / 5.0

# true
1 + 2 * 3 == 7 && 1 <= 2


# `=` 演算子の右結合性により、a = (b = 3) となり、a == 3 です
b == 3;
a = b = 3

# 注意：代入式の構文はまもなく廃止されるため、代入文に置き換えてください
b = 3
a = b

"a"   in  [1,"a"]   # true
"def" in  "abcdef"  # true
"a"   in  {"a": 1}  # true
"b"   in  {"a": 1}  # false

x = 1; y= [1]
x in y  # true

インデックス式¶

[] 添字演算子を使用して、list または map の要素を操作します。

インデックス式を使用して、list または map の要素の値を取得・変更したり、map に要素を追加したりできます。リストでは負のインデックスを使用できます。

構文例：

a = [1, 2 ,3, -1.]
b = {"a": [-1], "b": 2}

a[-1] = -2
b["a"][-1] = a[-1]

# 結果
# a: [1,2,3,-2]
# b: {"a":[-2],"b":2}

括弧式¶

括弧式を使用すると、二項式内のオペランドの演算優先順位を変更できますが、結合性は変更できません。

# 1 + 2 * 3 == 7

(1 + 2) * 3  # == 9

文¶

Platypus では、すべての式は値文と見なすことができます。式が文の区切り記号 ; または \n で終了する場合、その式は文として扱われます。以下のスクリプトは4つの文を含んでいます。

len("abc")
1
a = 2; a + 2 * 3 % 2

値文（式文）¶

式の後ろに文の区切り記号が続く場合、値文と見なすことができます。以下は4つの有効な文です。

# 浮動小数点数を文として使用
1.;

# 関数呼び出し式を文として使用
len("Hello World!"); len({"a": 1})

# 識別子を文として使用
abc

代入文¶

構文例：

key_a = "key-a"

# 識別子 a を左オペランドとし、a にリストリテラルを代入
a = [1, nil, 3]

# インデックス式を左オペランドとして使用
a[0] = 0
a[2] = {"key-b": "value-b"}
a[2][key_a] = 123

条件文¶

多くのプログラミング言語と同様に、if/elif の条件が成立するかどうかに応じて、対応する文ブロックに処理が移行します。いずれの条件も成立しない場合は else ブランチに処理が移行します。

if condition {

}

if condition {

} else {

}

if condition_1 {

} elif condition_2 {

} ... elif condition_n {

} else {

}

現在、condition は任意の式にできます。その値が組み込みデータ型のいずれかである限り、値がその型のデフォルト値の場合、式の値は false となります。

• 条件が int 型の値の場合、0 であれば条件は false、それ以外は true です。
• 条件が float 型の値の場合、0.0 であれば条件は false、それ以外は true です。
• 条件が string 型の値の場合、空文字列 "" であれば条件は false、それ以外は true です。
• 条件が bool 型の値の場合、条件はその値そのものです。
• 条件が nil 型の値の場合、条件は false です。
• 条件が map 型の値の場合、長さが0であれば条件は false、それ以外は true です。
• 条件が list 型の値の場合、長さが0であれば条件は false、それ以外は true です。

ループ文¶

Platypus は for 文と for in 文をサポートしています。

以下は、ループ文ブロック内でのみ使用できる2つの文です。

• continue 文：後続の文を実行せずに、次のループの反復を開始します。
• break 文：ループを終了します。

for 文を使用すると無限ループが発生する可能性があるため、注意して使用するか、可能な限り for in 文に置き換えてください。

for init-expr; condition; loop-expr {

}

for varb_name in map_value/list_value/string_value  {

}

使用例：

• for 文を使用して10回ループを実行：

for a = 0; a < 10; a = a + 1 {

}

• for in 文を使用して list のすべての要素を反復処理：

b = "2"
for a in ["1", "a" ,"2"] {
  b = b + a
  if b == "21a" {
    break
  }
}
# b == "21a"

• for in 文を使用して map のすべてのキーを反復処理：

d = 0
map_a = {"a": 1, "b":2}
for x in map_a {
  d = d + map_a[x]
}

• for in 文を使用して string のすべての文字を反復処理：

s = ""
for c in "abcdef" {
  if s == "abc" {
    break
  } else {
    continue
  }
  s = s + "a"
}
# s == "abc"