文字列とフォーマット
変換では、表示名、参照番号、メッセージ本文、またはレポートの行など、データから文字列を作成する必要があることがよくあります。 WELにはそのためのf-stringがあり、通常は連結よりも適切な選択肢です。
_ は、これらの例で式が受け取る入力です。詳細については、入力変数を参照してください。
文字列リテラル
WEL では、文字列リテラルを記述する方法が三つあります: シングルクオート、ダブルクオート、トリプルクオート。シングルクオートとダブルクオートはいずれも String を生成しますが、補間を行うのはダブルクオートだけです。シングルクオートまたはダブルクオートを三つ続けて('''...''' または """...""")、複数行にまたがる文字列を記述します。
| Formula | 結果 |
|---|---|
'single quotes' | single quotes |
"double quotes" | double quotes |
'literal ${1 + 1}' | literal ${1 + 1} |
"interpolated ${1 + 1}" | interpolated 2 |
シングルクオート文字列では、エスケープとして認識されるのは \\ と \' だけなので、${...} はプレーンテキストとしてそのまま出力されます。 ${ を含む可能性がある値には、正規表現パターンなどの場合、シングルクオートを使用します。値を埋め込む必要がある文字列には、ダブルクオートか f-string を使用します。
文字列の途中にアポストロフィが含まれる場合は、文字列が途中で閉じてしまうのを防ぐためにダブルクオートを使用します:
"O'Brien"シングルクオートまたはダブルクオートの文字列内に生の改行があると、リテラルが未終端のままになり、E003 エラーが発生します。ダブルクオート文字列では、代わりに \n または \r を使用できます。どちらのクオートスタイルでも文字列内にリテラルの改行を含めるには、トリプルクオート形式('''...''' または """...""")で文字列を記述します:
'''First line
Second line'''文字列はUTF-8であり、lengthはバイト数ではなくコードポイントをカウントします。 WELがテキストをカウントして保存する方法については、データ型を参照してください。
f-stringによる補間
文字列の先頭にfを付けると、その中の{...}が評価され、挿入されます。
| Formula | 結果 |
|---|---|
f"Order {upper('so-1')} total {1 + 2}" | Order SO-1 total 3 |
値を生成するものはすべて、フィールド、関数呼び出し、算術演算、またはパイプライン全体を含め、中かっこの中に入れることができます:
f"{capitalize(_.first_name)} {capitalize(_.last_name)} <{lower(trim(_.email))}>"++よりf-stringを優先する
++では両側の型が一致している必要があるため、混在したデータから作成するメッセージでは、まずすべての要素を変換する必要があります:
'Order ' ++ String(_.id) ++ ' has ' ++ String(_.count) ++ ' items'f-stringは補間時に変換を行い、結果は生成される文のように読み取れます:
f"Order {_.id} has {_.count} items"2つの文字列、または2つのリストを意図的に結合する場合は、++を使用します。
フォーマット仕様
中かっこの中のコロン(:)はフォーマット仕様を追加し、幅、配置、精度を制御します。
| Formula | 結果 |
|---|---|
f"{3.14159:.2f}" | 3.14 |
f"{42:05d}" | 00042 |
f"{'nur':>10}" | nur |
次の表に一般的な形式を示します:
| 仕様 | 効果 |
|---|---|
.Nf | 小数点以下N桁の固定小数点 |
0Nd | 先頭にゼロを付けてN桁にパディングされた整数 |
>N | 幅Nのフィールドで右揃え |
<N | 幅Nのフィールドで左揃え |
^N | 幅Nのフィールドで中央揃え |
n | ロケール形式の数値 |
c | ロケール形式の通貨 |
無効な仕様は解析時にE016を発生させるため、不正な形式は式が実行される前に検出されます。
フォーマットは丸めではありません
f"{_.total:.2f}"は小数点以下2桁のテキストを生成します。基になる値は丸められず、結果はStringであるため、その後の算術演算には対応していません。
丸めた値を後続の算術演算で使用できるようにするには、まずround_placesで丸めてから、結果をフォーマットします。
パディングと配置
フォーマット仕様でほとんどのケースに対応できます。テンプレート内ではなく値にパディングを適用する場合は、lpadおよびrpadを使用します:
lpad(String(_.line_no), 5, '0')ASCII以外のテキストを含む固定幅出力には、代わりにgrapheme_lpadおよびgrapheme_rpadを使用します。これにより、バイトカウンターではなく読み手にとって列が揃うようになります。
ロケール対応フォーマット
人が読む数値、通貨、日付は、手書きのパターンではなくロケールを通して処理する必要があります:
f"{_.customer_name}: {to_local_currency(_.total)}"to_local_currencyとto_local_stringは、Transform Dataアクションで設定されたdata-planeロケールを使用するため、別のリージョン向けに設定されたレシピでも同じ式が正しく機能します。フォーマット関数およびTransform dataアクションを参照してください。
c 書式指定は、to_local_currency と同じ出力を生成します。 to_local_string は小数点以下二桁に書式設定し、n はデフォルトでフル精度になります。 n に明示的に .2 の精度を指定して、to_local_string の出力と一致させます:
| Formula | 同等 |
|---|---|
f"{_.total:.2n}" | to_local_string(_.total) |
f"{_.total:c}" | to_local_currency(_.total) |
値を残りの式と組み合わせる必要がある場合は関数形式を使用し、特に数値がすでに f-string 内にあるなどテンプレート全体を一行に保ちたい場合は、書式指定の形式を使用します。
エスケープ
文字列をURL、CSVフィールド、クエリ、HTMLなどの別の形式に入れる場合は、値を挿入するときにエスケープします:
f"SELECT Id FROM Account WHERE Name = '{escape_for_soql(_.name)}'"引用符はクエリ構文の一部です。その間の値だけをエスケープします。値を他の形式に安全にエスケープする方法については、エスケープ関数を参照してください。
関連情報
最終更新日: