共通関数 ​

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

共通関数は、任意の型の値に対して動作します。ほぼすべての変換では、使用可能な値が存在するかどうか、またその値がどの型を保持しているかを知る必要があり、これらの関数はその両方に答えます。これらは、不完全なインバウンドデータにも耐えられる式を記述するための基盤です。

要素またはキーへのアクセス ​

次の関数は、List または Map から要素を1つ読み取ります:

at ​

List の指定インデックスにある要素、または Map の指定キーにある値を返します。

collection が List か Map かに関係なく、at は同じように動作します。型固有の例や、find_by や pluck などの関連関数については、List functions および Map functions を参照してください。

wel
at(collection, index)
パラメーター説明
collection読み取り対象の List または Map。その他のコレクション型は E100 を送出します。
インデックスList に対する Integer の位置、または Map に対する String のキー。負のインデックスは末尾から数えるため、-1 は List の最後の要素になります。
List の範囲外のインデックスは E201 を送出し、64ビット範囲外のインデックスは E211 を送出します。 Map のキーは完全一致で照合されるため、null 値を持つキーが存在する場合はエラーを送出せずに null を返し、存在しないキーの場合は捕捉可能な E104 を送出します。
位置によるリスト要素の取得

次の例は、インデックス 0 にある要素を返します:

Formula

wel
at(['pending', 'shipped', 'closed'], 0)

出力

text
保留中
キーによるマップ値の取得

次の例は、キーにある値を返します:

Formula

wel
at({sku: 'WID-1', qty: 3}, 'qty')

出力

wel
3

測定 ​

次の関数は、値のサイズをその型に適した単位で測定します。

length ​

Stringの長さをコードポイント数で返すか、List内の要素数、またはMap内のキー数を返します。

文字列の場合、lengthはバイト数ではなくコードポイント数をカウントします。一部の絵文字やアクセント付き文字は、複数のコードポイントが組み合わさって、ユーザーが1つの文字として認識する文字(書記素クラスタ)になっています。書記素クラスタについては、Unicode関数を参照してください。

wel
length(value)
パラメーター説明
valueString、List、またはMap。 null や Binary を含むその他の型は、E100 を送出します。
文字列内のコードポイントをカウント

次の例では、文字列内の各コードポイントをカウントします。

Formula

wel
length('hello')

出力

wel
5
リスト内の要素をカウント

次の例では、リスト内の各要素をカウントします。

Formula

wel
length(['a', 'b'])

出力

wel
2
マップ内のキーをカウント

次の例では、マップ内の各キーをカウントします。

Formula

wel
length({a: 1, b: 2, c: 3})

出力

wel
3

使用可能な値のテスト ​

次の関数は、値が単に非nullであるだけでなく、実際に使用可能かどうかをテストします。

present? ​

値が実際に使用可能な場合に true を返します: null ではなく、空でもなく、空白のみでもなく、Infinity でもありません。すべてのデータ型で動作します。

falseは、不在ではなくパイプライン内の意味のある値であるため、trueとして返されます。これはRubyのblank?とは異なります。

wel
present?(value)
パラメーター説明
valueE100を発生させるRegexを除く任意の値。
空でない文字列は存在する

次の例では、空でない文字列をテストします。

Formula

wel
present?('SO-1001')

出力

wel
true
空白のみの文字列は存在しない

次の例では、空白のみの文字列をテストします。

Formula

wel
present?('   ')

出力

wel
false
Nullは存在しない

次の例では、null値をテストします。

Formula

wel
present?(null)

出力

wel
false
空のリストは存在しない

次の例では、空のリストをテストします。

Formula

wel
present?([])

出力

wel
false
Falseは存在する

次の例では、不在ではなく意味のあるデータであるブール値falseをテストします。

Formula

wel
present?(false)

出力

wel
true

presence ​

値が存在する場合はその値を返し、存在しない場合や値が Skip の場合は null を返します。

presenceはpresent?のコンパニオンであり、この2つは異なるジョブに使用されます。 present?は、分岐に使用するBooleanを返します。 presence は、空文字列、空白のみの文字列、空のリストやマップ、Infinity など、あらゆる種類の「欠如」を単一の null に正規化します。これにより、フォールバック演算子|はそれらすべてを一度にキャッチできます。

wel
presence(_.nickname) | 'none'

presenceを使用しない場合、' 'を含むフィールドはnullではないため、|は空白をそのまま通過させます。

wel
presence(value)
パラメーター説明
valueE100を発生させるRegexを除く任意の値。
使用可能な値は変更されずに通過する

次の例では、使用可能な値を変更せずに通過させます。

Formula

wel
presence('SO-1001')

出力

text
SO-1001
空白のみの文字列はnullに正規化される

次の例では、空白のみの文字列をnullに正規化します。

Formula

wel
presence('   ')

出力

wel
null

ユースケース: 実際に入力されている最初の名前を選択 ​

CRMエクスポートでは、表示名が空白の場合があり、正式名が欠落している場合があります。 presenceを|で連結して、最初に使用可能な値にフォールスルーします。

入力

json
{
  "contacts": [
    {"id": "C-1", "display_name": "  ", "legal_name": "Kalani Park"},
    {"id": "C-2", "display_name": "Noam", "legal_name": "Noam Gupta"},
    {"id": "C-3", "display_name": null, "legal_name": null}
  ]
}

Formula

wel
_.contacts >> map_by(c ~> {
  id: c.id,
  name: presence(c.display_name) | presence(c.legal_name) | 'Unknown'
})

出力

json
[
  {"id": "C-1", "name": "Kalani Park"},
  {"id": "C-2", "name": "Noam"},
  {"id": "C-3", "name": "Unknown"}
]

C-1は、' 'が欠落ではなく空白であり、単純なnullチェックではまさにこのケースがすり抜けて宛先に渡されるため、フォールスルーします。

型の検査 ​

次の関数は、値が実際に16個のWEL型のどれであるかを報告します。

type_of ​

値の型の名前をStringとして返します。 type_of を Lambda に対して呼び出すと、E107 を送出します。

ルールをペイロードのどのリーフに適用するかを決定する条件ラムダを記述する場合や、予期しない入力で失敗している変換を診断する場合に最も役立ちます。

wel
type_of(value)
パラメーター説明
value任意の値。
文字列

次の例では、文字列の型を返します。

Formula

wel
type_of('SO-1001')

出力

text
文字列
整数

次の例では、整数の型を返します。

Formula

wel
type_of(42)

出力

text
整数
小数

次の例では、小数の型を返します。

Formula

wel
type_of(Decimal('1.50'))

出力

text
小数
リスト

次の例では、リストの型を返します。

Formula

wel
type_of([1])

出力

text
リスト
マップ

次の例では、マップの型を返します。

Formula

wel
type_of({a: 1})

出力

text
Map
Null

次の例では、null値の型を返します。

Formula

wel
type_of(null)

出力

text
Null

TYPE_OFは実際に保持しているものを報告する

どちらも数値のように見えますが、type_of(42)はIntegerで、type_of(Decimal('1.50'))はDecimalです。算術演算で予期しない結果が生成される場合は、型を確認してください。その理由を判断するための推奨される方法です。各WEL型が何を表すかについては、データ型を参照してください。

  • データ型:16個のWELデータ型と、それぞれを使用するタイミング。
  • 演算子: フォールバック演算子|の詳細情報。
  • List functions: さらに多くの List 関数があります。たとえば、条件で検索するための find_by などがあります。
  • Map functions: さらに多くの Map 関数があります。たとえば、少数のキーに絞り込むための pluck などがあります。
  • ディープマップ関数: 条件ラムダ内でtype_ofを使用します。
  • Unicode関数: 読み手に見える方法でテキストをカウントします。

最終更新日: