共通関数 ​

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

測定 ​

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

length ​

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

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

length(value)

length('hello')

5

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

2

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

3

使用可能な値のテスト ​

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

present? ​

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

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

present?(value)

present?('SO-1001')

true

present?('   ')

false

present?(null)

false

present?([])

false

present?(false)

true

presence ​

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

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

presence(_.nickname) | 'none'

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

presence(value)

presence('SO-1001')

SO-1001

presence('   ')

null

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

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

入力

{
  "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

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

出力

[
  {"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(value)

type_of('SO-1001')

文字列

type_of(42)

整数

type_of(Decimal('1.50'))

小数

type_of([1])

リスト

type_of({a: 1})

Map

type_of(null)

Null

関連情報 ​

• データ型：16個のWELデータ型と、それぞれを使用するタイミング。
• 演算子: フォールバック演算子|の詳細情報。
• ディープマップ関数: 条件ラムダ内でtype_ofを使用します。
• Unicode関数: 読み手に見える方法でテキストをカウントします。