データ

Data は、ブループリントが計算に使う値を保持するカテゴリです。定数が必要なとき、値が想定と違う型で届いたとき、あるいは文字列・配列・JSON ドキュメントを分解する必要があるときに使います。ここにあるノードのほとんどは実行ピンを持ちません——Data ノードは、その出力に配線された側から読み取られます。Memoだけが例外であり、それについてはこのページの末尾で説明します。

値の型

以下のピンには10種類のvalueTypeが現れます。

2つのデータピン間の接続は、型が完全に一致する場合、または次のいずれかが成り立つ場合に許可されます。

他のカテゴリの型も同じ形でのみ広がります——elementはどのelement:nl.…ピンにも接続でき、その逆方向にも接続できます。ImageAssetとstringはどちらもImageAsset|null入力に届きます。

それ以外はすべて拒否されます。作者が動くはずだと思い込みがちな逆方向の接続も含めてです。

• json → array、json → Rect。 どの拡張規則も一方向にしか成り立ちません。任意のオブジェクトが矩形であるとは限りません。
• float → integer。 To Integerを挟んでください。これはゼロ方向に切り捨てます。
• string → integerまたはfloat。 Parse Int、Parse Float、To Integer、To Floatのいずれかを挟んでください。
• boolean → string、json → string。 テキストへ暗黙変換されるのは数値だけです。To StringまたはStringify JSONを挟んでください。
• string、integer、float、boolean → json。 json入力に暗黙に届く型はarrayとRectだけです。To JSONを挟んでください。
• RGBAColor → json、Vector2D → json。 これらはそれぞれ独立した構造化型であり、JSON ドキュメントではありません。Break Vector2Dで分解するか、Make Objectでドキュメントを組み立ててください。

規約

• このページのノードは、1つを除いてすべて純粋です。 接続できる実行ピンがないため、Data ノードは実行経路の上に置くことができません。その出力は、消費側が読み取るときに計算され、次の読み取りで再計算されます。Memoは例外です——値をそのまま保持することは、純粋なノードにはできないことそのものであるため、これは実行ノードになっています。
• 3種類のグラフすべてがこれらを受け付けます——event、function、macro——そして Blueprint Value グラフも同様です。ここでもMemoは例外であり、eventとmacroでのみ利用できます。
• インプレースでの変更は存在しません。 書き込みを行うノードは、出力ピンに新しい値を返し、入力にはまったく手を加えません。
• カード上のリテラルが存在するのはstring、integer、float、booleanのピンだけです。 jsonまたはarrayの入力にはカード上のエディタが存在しません——JSONリテラル、またはMake Object / Make Arrayノードを渡してください。
• 未配線の入力はエラーではありません。 そのピンのカード上のリテラルを読み取り、リテラルがなければ何も読み取りません。そして各ノードはそれを正規化します——欠けた配列は空として、欠けた文字列は""として、欠けた数値は0として読み取られます。
• 純粋なノードの連鎖は、最大32段まで解決されます。 それを超えると、読み取りは何も返さず、静かに終わります。

リテラル

リテラルは1つの出力ピンと1つのカード上のフィールドを持ちます。その型は選んだノードによって固定され、それによってグラフの残りの部分が型チェックできるようになります。

String

blueprint.data.stringLiteral · Pure

カード上のフィールド

Integer

blueprint.data.integerLiteral · Pure

カード上のフィールド

Float

blueprint.data.floatLiteral · Pure

カード上のフィールド

Boolean

blueprint.data.booleanLiteral · Pure

カード上のフィールド

Null

blueprint.data.nullLiteral · Pure

カード上のフィールドを持たない唯一のリテラルです——nullについて設定できることは何もありません。その出力の型はjsonであるため、あらゆるjsonまたはanyの入力に届きます。

JSON

blueprint.data.jsonLiteral · Pure

カードにはルートの型と概要が表示されます。編集を開始すると、オブジェクトには名前付きフィールド、配列には順序付きの項目を持つツリー形式のフォームが開きます。新規ノードは空のオブジェクトから始まります。

カード上のフィールド

Color

blueprint.data.colorLiteral · Pure

カラーピッカーで編集し、8桁の RGBA 16進数として表示されます。出力は常に正規化された{ r, g, b, a }のレコードです——r、g、bはバイト値、aは0から1。

カード上のフィールド

Vector2D

blueprint.data.vector2dLiteral · Pure

カード上のフィールド

Rect

blueprint.data.rectLiteral · Pure

ColorやVector2Dと同様に、Rectもそれ自身の型です。それらと異なり、Rectはjsonにも広がるため、あらゆるjson入力に接続できます——理由については値の型の注記を参照してください。

カード上のフィールド

Number

blueprint.data.numberLiteral · Pure

旧式の数値定数であり、新しいグラフに追加できないようパレットから非表示になっています。旧いグラフの解決を保つために登録だけは残されています。新規にはFloatを使ってください。

カード上のフィールド

Literal

blueprint.data.literal · Pure

旧式の型なし定数であり、これもパレットから非表示になっています。そのany型の出力はあらゆるものと型チェックを通ってしまいます——それこそが、型付きのリテラル群がこれを置き換えた理由です。

カード上のフィールド

変換

これらは、接続ルールがあなたを導く先のノード群です。どれも失敗しません——読み取れない入力は、エラーではなくその型のゼロ値を生成します。

To String

blueprint.string.toString · Pure

nullと未配線の入力はどちらも""として読み取られます。オブジェクトや配列は JSON テキストにシリアライズされます。

To Integer

blueprint.data.toInteger · Pure

ゼロ方向に切り捨てます——-2.7は-3ではなく-2になります。trueは1、falseは0として読み取られ、数値の文字列は受け付けられます。それ以外はすべて0になります。

To Float

blueprint.data.toFloat · Pure

To Integerと同じ受け付け方ですが、切り捨ては行いません。有限の数値でない値は0になります。

To Boolean

blueprint.data.toBoolean · Pure

文字列はトリムして小文字化したうえで照合されます——""、"false"、"0"、"no"は偽、"true"、"1"、"yes"は真であり、それ以外の空でない文字列はすべて真になります。0と有限でない数値は偽になります。

To JSON

blueprint.data.toJson · Pure

文字列は JSON としてパースされ、パースできなければ元の文字列のまま保たれます——そのためこのノードがテキストを壊すことはありません。それ以外の値は JSON セーフな形にされます——有限でない数値や循環参照はnullに、関数やシンボルはそのテキスト形式になります。

Parse Int

blueprint.data.parseInt · Pure

10進数として扱われ、先頭の数値部分が採用されます——"12px"は12になります。数字がまったくない場合は0になります。

Parse Float

blueprint.data.parseFloat · Pure

Parse JSON

blueprint.data.parseJson · Pure

厳密です——パースできないテキストと空文字列は、どちらもnullになります。元のテキストを残したいときは代わりにTo JSONを使ってください。

Stringify JSON

blueprint.data.stringifyJson · Pure

未配線の入力はテキスト"null"になります。シリアライズできない値は""になります。

型判定

それぞれがanyを受け取り、実際に届いた値についての問いに答えます——これが、jsonやanyのピンが本当は何を運んでいるかを知る方法です。

Is String

blueprint.data.isString · Pure

Is Number

blueprint.data.isNumber · Pure

有限の数値だけが対象です——NaNと無限大は偽であり、数値の文字列も偽になります。これは型について尋ねるものであり、パース可能かどうかについてではありません。

Is Boolean

blueprint.data.isBoolean · Pure

Is Array

blueprint.data.isArray · Pure

Is Object

blueprint.data.isObject · Pure

配列ではない、nullでないオブジェクトに対して真になります。配列に答えるのはこれではなくIs Arrayです。

Is Null

blueprint.data.isNull · Pure

nullに対して真になり、また何にも解決されなかった入力に対しても真になります——未配線のピンはここでは null として読み取られます。

Not Null

blueprint.data.notNull · Pure

Is Nullの否定であり、これによってNotをぶら下げる必要がなくなります。

Is Empty Value

blueprint.data.isEmptyValue · Pure

null、""、空の配列、空のオブジェクトに対して真になります。0とfalseは空ではなく値であり、どちらも偽になります。

文字列

ここでのすべてのvalue入力はカード上のリテラルを受け付けるため、一度きりの文字列のために専用のリテラルノードを用意する必要はありません。添字は0始まりであり、範囲外の添字は拒否されるのではなくクランプされます。

Concat

blueprint.string.concat · Pure

その入力を、ピンの順に、間に何も挟まずに連結します。カードには入力追加コントロールがあり、aとbを超えてさらにstring入力を追加できます。以下のシグネチャは、最初から存在する2つだけを示しています。

Format

blueprint.string.format · Pure

テンプレート内の{name}を、valuesの対応するフィールドで置き換えます。valuesが配列の場合は{0}、{1}……で置き換えます。一致しないプレースホルダーは空になり、valuesがオブジェクトでも配列でもない場合はすべてのプレースホルダーが空になります。

Length

blueprint.string.length · Pure

Is Empty

blueprint.string.isEmpty · Pure

長さがゼロであることです。空白だけの文字列は空ではありません——それはIs Blankが扱います。

Is Blank

blueprint.string.isBlank · Pure

空である、または空白しか含みません。

Trim

blueprint.string.trim · Pure

Trim Start

blueprint.string.trimStart · Pure

Trim End

blueprint.string.trimEnd · Pure

To Upper Case

blueprint.string.toUpperCase · Pure

To Lower Case

blueprint.string.toLowerCase · Pure

Capitalize

blueprint.string.capitalize · Pure

先頭の文字だけを大文字にし、それ以外はそのまま残します——タイトルケースではありません。

Equals

blueprint.string.equals · Pure

Equals Ignore Case

blueprint.string.equalsIgnoreCase · Pure

Contains

blueprint.string.contains · Pure

Starts With

blueprint.string.startsWith · Pure

Ends With

blueprint.string.endsWith · Pure

Index Of

blueprint.string.indexOf · Pure

startから前方へ検索し、一致がない場合は-1を返します。startは文字列の範囲内にクランプされるため、範囲外の値は失敗するのではなく先頭または末尾から検索されます。

Last Index Of

blueprint.string.lastIndexOf · Pure

末尾から後方へ検索します。startピンは存在しません——それがIndex Ofとの唯一の非対称点です。

Count

blueprint.string.count · Pure

重ならない出現回数を数えます。空のsearchは、文字列の長さではなく0になります。

Char At

blueprint.string.charAt · Pure

文字列の範囲外の添字は、エラーではなく""になります。

Substring

blueprint.string.substring · Pure

2番目のピンは終了位置ではなく長さです。どちらも文字列の範囲内にクランプされ、未配線のlengthはstart以降のすべてを取ります。

Insert

blueprint.string.insert · Pure

indexは文字列の範囲内にクランプされ、読み取れない添字は末尾に追加されます。

Replace

blueprint.string.replace · Pure

最初の出現だけを置き換えます。空のsearchは、あらゆる位置に挿入するのではなく、値をそのまま返します。

Replace All

blueprint.string.replaceAll · Pure

すべての出現を置き換えます。searchはパターンではなく単なるテキストです——空のsearchは、この場合も値をそのまま返します。

Repeat

blueprint.string.repeat · Pure

countは0–10000にクランプされるため、暴走した数値が無制限な文字列を作ることはありません。

Pad Start

blueprint.string.padStart · Pure

lengthは追加する文字数ではなく、目標となる合計の長さです。すでに十分な長さの文字列は変更されずに返ります。

Pad End

blueprint.string.padEnd · Pure

Split

blueprint.string.split · Pure

結果の型はarrayではなくjsonであるため、Join、For Each、その他のjson入力には届きますが、Array …ノード群には届きません。

Join

blueprint.string.join · Pure

arrayを受け取るArray Joinとは異なり、これはjsonを受け取ります。valuesが配列でない場合は""になります。

Matches Regex

blueprint.string.matchesRegex · Pure

patternは、区切り記号もフラグも付かない正規表現のソースそのものです。コンパイルできないパターンは、例外を投げるのではなくfalseになります。

Extract Regex

blueprint.string.extractRegex · Pure

パターンにキャプチャグループがある場合はその最初のものを、なければマッチ全体を返します。マッチしない場合、またはコンパイルできないパターンの場合は""になります。

Normalize Line Breaks

blueprint.string.normalizeLineBreaks · Pure

\r\nおよび単独の\rを\nに書き換えます。これにより、どのプラットフォームから貼り付けたテキストでも、比較や分割が一貫して行えます。

配列

これらはすべて、array入力を配列として読み取り、配列でない場合は空の配列に置き換えます。そのため何も例外を投げません。書き込みを行うものはすべて、resultに新しい配列を返します。

Array Length

blueprint.collection.arrayLength · Pure

Array Get

blueprint.collection.arrayGet · Pure

負の添字、または末尾を超える添字はnullになります。出力の型がjsonなのは、配列の要素が任意の JSON 値になりうるためです。

Array Set

blueprint.collection.arraySet · Pure

indexの位置に書き込み、新しい配列を返します。負の添字、または10000を超える添字は、入力をそのまま返します。末尾を超える添字は配列を拡張し、飛ばされたスロットは空のままになります。

Array Push

blueprint.collection.arrayPush · Pure

末尾に追加します。

Array Insert

blueprint.collection.arrayInsert · Pure

indexは0から配列の長さまでにクランプされるため、範囲外の添字は失敗するのではなく末尾に追加されます。

Array Remove

blueprint.collection.arrayRemove · Pure

itemと等しい最初の要素を削除します。比較は JSON の値で行われます——同じフィールドを持つ2つのオブジェクトは、たとえ別のオブジェクトであっても一致します。一致しない場合は入力をそのまま返します。

Array Remove At

blueprint.collection.arrayRemoveAt · Pure

1つの要素を削除し、空いた隙間を詰めます。範囲外の添字は入力をそのまま返します。

Array Contains

blueprint.collection.arrayContains · Pure

Array Removeと同じ規則である JSON 値としての等価性で比較します。これは、同一性を比較するMathのEqualより意図的に緩くなっています。

Array Slice

blueprint.collection.arraySlice · Pure

endは含まれません。両方の境界は配列の範囲内にクランプされ、未配線のendは末尾まで実行されます。

Array Join

blueprint.collection.arrayJoin · Pure

各要素をテキストに変換し——オブジェクトと配列は JSON になります——それらを連結します。文字列のJoinがjsonを受け取るのに対し、こちらはarrayを受け取ります。

Array First

blueprint.collection.arrayFirst · Pure

Array Last

blueprint.collection.arrayLast · Pure

Array Is Empty

blueprint.collection.arrayIsEmpty · Pure

Array Index Of

blueprint.collection.arrayIndexOf · Pure

itemと等しい最初の要素の位置。Array Containsと同じ方法で値により比較します。一致しない場合は-1。

Array Concat

blueprint.collection.arrayConcat · Pure

aに続けてbを並べた、新しい配列。

Array Reverse

blueprint.collection.arrayReverse · Pure

Array Unique

blueprint.collection.arrayUnique · Pure

後から出てくる重複を捨て、それぞれ最初のものだけを残します。要素は値によって比較されるため、同じフィールドを持つ2つのオブジェクトは1つとして扱われます。

Array Range

blueprint.collection.arrayRange · Pure

startから始まり、それぞれstepずつ進むcount個の数値。ページが何かをN個描画する必要があり、その数値自体がコンテンツになる場合に使う配列です。

Array Find By Key

blueprint.collection.arrayFind · Pure

keyフィールドがvalueと等しい最初の要素と、その位置。

Array Filter By Key

blueprint.collection.arrayFilter · Pure

keyフィールドがvalueと等しいすべての要素を、元の順序のまま返します。

Array Sort By Key

blueprint.collection.arraySort · Pure

レコードをそのフィールドの1つによって並べ替えます。この key ベースの3つのノードは、比較関数ではなくフィールド名を受け取ります——比較関数は関数値であり、レコードをそのフィールドの1つで並べ替えることこそが、実際にリストが必要としているものだからです。

数値は数値として比較され、真偽値はfalseがtrueより前になり、それ以外はすべてテキストとして、ランタイムが文字列を照合する方法で順序付けられます。フィールドが欠けている、nullである、または""である要素は、どちらの方向でも末尾に並びます。同順位は届いた順序を保ちます。空のkeyは配列をそのまま返します。

JSON Array Length

blueprint.data.jsonArrayLength · Pure

Array Lengthの旧名であり、既存のグラフの解決を保つために残されています。配列でない値は0になります。新しいグラフではArray Lengthを使ってください。

ジオメトリ

Vector2DとRectは JSON ドキュメントではなく構造化された型であるため、Get JSON Fieldではなく専用のノードで組み立てたり分解したりします。すべての入力は、数値でない値を0として読み取ります。

Make Vector2D

blueprint.data.makeVector2d · Pure

Vector2Dリテラルとは異なり、両方の成分を配線できます——これは、点を計算で求めるときにMove Mouse Toが必要とするものです。

Break Vector2D

blueprint.data.breakVector2d · Pure

Make Rect

blueprint.data.makeRect · Pure

負のwidthやheightは、そのまま保持されるのではなく正規化されます——原点が移動し、大きさは正の値になります。そのため、得られる矩形は実際に描いたとおりのものになります。

Break Rect

blueprint.data.breakRect · Pure

Rect Center

blueprint.data.rectCenter · Pure

矩形の4辺から等距離にある点。

オブジェクト

これらは、名前によって一度に1つのフィールドに作用します。パスは受け取りません——ネストした書き込みにはSet JSON Fieldを使ってください。オブジェクトでない入力は{}として読み取られます。

Object Keys

blueprint.collection.objectKeys · Pure

挿入順のフィールド名。配列やその他のオブジェクトでない値は、空の配列になります。

Object Values

blueprint.collection.objectValues · Pure

Object Set Field

blueprint.collection.objectSetField · Pure

fieldは単なる名前であり、その中のドットはパスの区切りではなく名前の一部として扱われます。空の名前はコピーをそのまま返します。

Object Remove Field

blueprint.collection.objectRemoveField · Pure

Object Merge

blueprint.collection.objectMerge · Pure

浅いマージであり、衝突した場合はbが優先されます。ネストしたオブジェクトはマージされず、置き換えられます。Merge JSON Objectは、別の型 id を持つ同一の操作です。

JSON

パスを扱うノードは、ドット記法でドキュメントを指し示します——user.profile.nameのように、また配列の添字には数値のセグメントを使います——items.0のように。キーの中のリテラルなドットは\.としてエスケープします。空のパスはドキュメント全体を意味するため、パスを指定しないSet JSON Fieldはそれをまるごと置き換えます。

Get JSON Field

blueprint.data.jsonGet · Pure

存在しないパスはnullになるため、存在しないフィールドとnullを保持するフィールドは同じように読み取られます。その違いが重要な場合はHas JSON Fieldを使ってください。

Has JSON Field

blueprint.data.jsonHas · Pure

真偽値ではなく存在の有無を見ます——値がnullであるフィールドも、存在はしています。

Set JSON Field

blueprint.data.jsonSet · Pure

入力をコピーし、そのコピーへ書き込みます。パスの途中で欠けているコンテナは作成されます——次のセグメントが数値であれば配列、そうでなければオブジェクトになります。そのため、空のドキュメントへstats.hpを書き込むと{ "stats": { "hp": … } }が生成されます。

Remove JSON Field

blueprint.data.jsonRemove · Pure

オブジェクトのフィールドを削除するか、配列の項目を取り除いて後続の要素を詰めます。存在しないパスは、コピーをそのまま返します。

Make Object

blueprint.data.jsonMakeObject · Pure

動的なピンの組からオブジェクトを組み立てるため、下のシグネチャは出力のみを示します。カード上の各フィールドは、Name入力（string、カード上のリテラルを受け付ける）とValue入力（any）を1組追加します。新規ノードは1組から始まります。名前は実行時に読み取られるため、配線されたNameはキーを計算で求められます。名前が空である、または前に出てきた名前と重複するフィールドはスキップされます。

Make Array

blueprint.data.jsonMakeArray · Pure

動的なItem入力をピンの順に並べて配列を組み立てるため、下のシグネチャは出力のみを示します。新規ノードはどのピンも持たない状態から始まります——カード上で追加してください。これがarray型を生成するノードであり、組み立てた配列をArray Lengthや List のSet Itemsへ渡す方法です。

Merge JSON Object

blueprint.data.jsonMergeObject · Pure

bが優先される浅いマージであり、Object Mergeと同一です。オブジェクトでない入力は{}として扱われます。

Clone JSON

blueprint.data.jsonClone · Pure

深く、JSON セーフなコピー。書き込み系のノードはすでに入力をコピーしているため、これが必要になるのは、同じドキュメントを、互いの変更を見てはならない2つの分岐へ渡そうとするときだけです。

値を保持する

Memo

blueprint.data.memo

実行がそこを通過するときに一度だけ入力を読み取り、次に実行がそこを通過するまで、その値を出力に保持し続けます。

これは、このカタログの中で複数の消費先に供給してよい唯一のデータ出力です。それ以外はすべて単一消費であり、その理由は2つあります——純粋なノードは読み取るたびに再評価されるため、1つのRandom Floatを3つのピンに配線すると3つの数値が得られてしまいます。そして実行ノードの出力は、それを生成したパルスに属します。Memo にはただ1つの書き手——自分自身——しかいないため、どの読み取りも、その書き込みが残した値を返し、複数へ分岐させても誰も驚きません。

意図的に latent ではなく同期的です——待つべきものが何もなく、latent なノードはインラインのストーリー値の中では使えないためです。functionグラフは純粋なままであるため、Memo をその中に置くことはできません。