文字列Formula ​

Rubyでは、文字列はテキストと文字のシーケンスを指します。 Workatoはさまざまな文字列Formulaをサポートしています。

WorkatoのFormulaは、許可リストに登録されたRubyメソッドです。 これらのFormulaの構文と機能は、通常変更されていません。 Formulaがnull（Rubyではnilと表されます）に対して動作する場合、present?、presence、blank?を除き、ほとんどのFormulaはエラーを返し、ジョブを停止します。

詳細については、Rubyドキュメントの文字列を参照してください。 ただし、許可リストに登録されたRubyメソッドのみがサポートされます。 許可リストへの新しいFormulaの追加をリクエストするには、Customer Success Managerにお問い合わせください。

次の例は、Workatoで文字列を操作するために使用できるメソッドを示しています。

条件 ​

このセクションでは、文字列の条件Formulaについて説明します。 条件の完全なリファレンスについては、Conditionsを参照してください。

blank? ​

Rubyの慣例に従って、入力が空白とみなされるかどうかをチェックします。 これには以下が含まれます:

• Null値
• 空の入力
• falseのブール値
• 空白文字のみを含む文字列
• 値を持たない数値。NaN（not a number）と呼ばれることがあります。 これは未定義の値、または表現できない値です。 たとえば、ゼロ除算の結果、または欠損値です。

構文 ​

Input.blank?

• Input - 入力データピル。 これは、文字列、数値、日付、日時、ブール値、配列、またはオブジェクトデータ型にできます。

サンプル利用状況 ​

仕組み ​

入力がRubyの慣例に従って空白とみなされる場合、Formulaはtrueを返します。 その他のデータの場合は、falseを返します。

関連項目 ​

• presence: データが存在する場合はデータを返し、存在しない場合はnilを返します。
• present?: 有効な入力がある場合はtrueを返します。

is_not_true? ​

ブール値を評価し、評価された値がtrueでない場合にtrueを返します。

構文 ​

Input.is_not_true?

• Input - 入力ブール値、整数（1または0）、または許可された文字列値。

サンプル利用状況 ​

仕組み ​

入力を受け取り、それがtrueかfalseかを評価します。

関連項目 ​

• is_true: ブール値を評価し、評価された値がtrueの場合にtrueを返します。

is_true? ​

ブール値を評価し、評価された値がtrueの場合にtrueを返します。

構文 ​

Input.is_true?

• Input - 入力ブール値、整数（1または0）、または許可された文字列値。

サンプル利用状況 ​

仕組み ​

入力を受け取り、それがtrueかfalseかを評価します。

関連項目 ​

• is_not_true: ブール値を評価し、評価された値がtrueでない場合にtrueを返します。

present? ​

このFormulaは入力を確認し、値が存在する場合はtrueを返します。 入力がnil、boolean false、空の文字列、または空のリストの場合、Formulaはfalseを返します。

構文 ​

Input.present?

• Input - 入力データピル。 文字列、数値、日付、またはリストのデータ型を使用できます。

サンプル利用状況 ​

仕組み ​

入力がnull、空の文字列、または空のリストの場合、Formulaはfalseを返します。 その他のデータの場合はtrueを返します。

関連項目 ​

• presence: データが存在する場合はデータを返し、存在しない場合はnilを返します。
• blank?: データが存在しない場合、または文字列が空白のみで構成されている場合にnilを返します。

presence ​

データが存在する場合はそのデータを返し、存在しない場合はnilを返します。

構文 ​

Input.presence

• Input - 入力データピル。 文字列、数値、日付、または日時のデータ型を使用できます。

サンプル利用状況 ​

仕組み ​

入力がnullまたは空の文字列の場合、Formulaはnilを返します。 その他のデータの場合は、元の入力データを返します。

関連項目 ​

• blank?: データが存在しない場合、または文字列が空白のみで構成されている場合にnilを返します。
• present?: 有効な入力がある場合はtrueを返します。

include? ​

文字列に特定の部分文字列が含まれているかどうかを確認します。 含まれる場合はtrueを返します。

構文 ​

Input.include?(substring)

• Input - 入力文字列。
• substring - 確認する部分文字列。

利用例 ​

仕組み ​

このFormulaは、文字列に特定の部分文字列が含まれているかどうかを確認します。 このFormulaは、文字列に部分文字列が含まれている場合はtrueを返し、含まれていない場合はfalseを返します。 部分文字列では大文字と小文字が区別されます。

このFormulaはexclude?とは逆の動作をします。 このFormulaは、入力文字列に指定されたキーワードが含まれている場合にのみtrueを返します。

関連項目 ​

• exclude?: 文字列に特定の部分文字列が含まれているかどうかを確認します。 含まれる場合はfalseを返します。

exclude? ​

文字列に特定の部分文字列が含まれているかどうかを確認します。 含まれる場合はfalseを返します。

構文 ​

Input.exclude?(substring)

• Input - 入力文字列。
• substring - 確認する部分文字列。

利用例 ​

仕組み ​

このFormulaは、文字列に特定の部分文字列が含まれているかどうかを確認します。 含まれる場合はfalseを返し、それ以外の場合はtrueを返します。 この部分文字列では大文字と小文字が区別されます。

この関数はinclude?とは逆の動作をします。 入力文字列に指定されたキーワードが含まれていない場合にのみtrueを返します。

関連項目 ​

• include?: 文字列に特定の部分文字列が含まれているかどうかを確認します。 含まれる場合はtrueを返します。

match? ​

文字列に特定の正規表現（regex）パターンが含まれているかどうかを確認します。 含まれる場合はtrueを返します。

構文 ​

Input.match?(pattern)

• Input - 入力文字列。
• pattern - 確認するregexパターン。

サンプル利用状況 ​

仕組み ​

このFormulaは、文字列に特定のregexパターンが含まれているかどうかを確認します。 含まれる場合はtrueを返し、それ以外の場合はfalseを返します。

関連項目 ​

• include?: 文字列に特定の部分文字列が含まれているかどうかを確認します。 含まれる場合はtrueを返します。
• exclude?: 文字列に特定の部分文字列が含まれているかどうかを確認します。 含まれる場合はfalseを返します。

ends_with? ​

文字列が特定の部分文字列で終わるかどうかを確認します。 含まれる場合はtrueを返します。

構文 ​

Input.ends_with?(substring)

• Input - 入力文字列。
• substring - 確認する部分文字列。

サンプル利用状況 ​

仕組み ​

このFormulaは、文字列が特定の部分文字列で終わるかどうかを確認します。 含まれる場合はtrueを返し、それ以外の場合はfalseを返します。

関連項目 ​

• include?: 文字列に特定の部分文字列が含まれているかどうかを確認します。 含まれる場合はtrueを返します。
• exclude?: 文字列に特定の部分文字列が含まれているかどうかを確認します。 含まれる場合はfalseを返します。
• match?: 文字列に特定のパターンが含まれているかどうかを確認します。 含まれる場合はtrueを返します。
• starts_with?: 文字列が特定の部分文字列で始まるかどうかを確認します。 含まれる場合はtrueを返します。

starts_with? ​

文字列が特定の部分文字列で始まるかどうかを確認します。 含まれる場合はtrueを返します。

構文 ​

Input.starts_with?(substring)

• Input - 入力文字列。
• substring - 確認する部分文字列。

サンプル利用状況 ​

仕組み ​

このFormulaは、文字列が特定の部分文字列で始まるかどうかを確認します。 含まれる場合はtrueを返し、それ以外の場合はfalseを返します。

関連項目 ​

• include?: 文字列に特定の部分文字列が含まれているかどうかを確認します。 含まれる場合はtrueを返します。
• exclude?: 文字列に特定の部分文字列が含まれているかどうかを確認します。 含まれる場合はfalseを返します。
• match?: 文字列に特定のパターンが含まれているかどうかを確認します。 含まれる場合はtrueを返します。
• ends_with?: 文字列が特定の部分文字列で終わるかどうかを確認します。 含まれる場合はtrueを返します。

テキスト操作 ​

このセクションには、文字列内のテキストを操作できるFormulaが含まれています。

parameterize ​

文字列内の特殊文字を標準文字に置き換えます。 アプリが標準外の文字を受け付けない場合に使用します。

構文 ​

Input.parameterize

• Input - 入力文字列。

サンプル利用状況 ​

仕組み ​

このFormulaは、文字列内のすべての特殊文字を検索し、それらを標準文字に置き換えます。

lstrip ​

このFormulaは、入力文字列の先頭にある空白を削除します。

構文 ​

String.lstrip

• String - 入力文字列。

サンプル利用状況 ​

仕組み ​

このFormulaは、文字列の先頭から空白を削除します。 文字列の前に空白がない場合、入力文字列はそのまま返されます。

関連項目 ​

• strip: 入力文字列の先頭と末尾にある空白を削除します。
• rstrip: 入力文字列の末尾にある空白を削除します。
• gsub: テキスト文字列の一部を置き換えます。 置き換えられた文字を含む新しい文字列を返します。

rstrip ​

このFormulaは、入力文字列の末尾にある空白を削除します。

構文 ​

String.rstrip

• String - 入力文字列。

サンプル利用状況 ​

仕組み ​

このFormulaは、文字列の末尾から空白を削除します。 文字列の末尾に空白がない場合、入力文字列はそのまま返されます。

関連項目 ​

• strip: 入力文字列の先頭と末尾にある空白を削除します。
• lstrip: 入力文字列の先頭にある空白を削除します。
• gsub: テキスト文字列の一部を置き換えます。 置き換えられた文字を含む新しい文字列を返します。

scrub ​

文字列が無効なバイトシーケンスの場合、このFormulaは無効なバイトを置換文字に置き換えます。 文字列が無効でない場合、このFormulaは元の文字列を返します。

構文 ​

String.scrub(replacement string)

• String - 入力文字列。

サンプル利用状況 ​

strip ​

このFormulaは、入力文字列の先頭と末尾にある空白を削除します。

構文 ​

String.strip

• String - 入力文字列。

サンプル利用状況 ​

仕組み ​

このFormulaは、文字列の両端から空白を削除します。 文字列のどちらの端にも空白がない場合、入力文字列はそのまま返されます。

関連項目 ​

• lstrip: 入力文字列の先頭にある空白を削除します。
• rstrip: 入力文字列の末尾にある空白を削除します。
• gsub: テキスト文字列の一部を置き換えます。 置き換えられた文字を含む新しい文字列を返します。

strip_tags ​

このFormulaは、文字列に埋め込まれたHTMLタグを削除します。

構文 ​

String.strip_tags

• String - 入力文字列。

サンプル利用状況 ​

仕組み ​

このFormulaは、入力文字列内のHTMLタグを確認します。 見つかったHTMLタグを削除し、文字列を返します。

関連項目 ​

• strip: 入力文字列の先頭と末尾にある空白を削除します。

ljust ​

文字列を左揃えにし、文字列が指定された長さになるまで空白または指定された文字/文字列でパディングします。

構文 ​

String.ljust(length,character)

• String - 入力文字列。
• length - 出力文字列の長さ。
• character - （任意）入力文字列のパディングに使用する文字または文字列。 指定しない場合、デフォルトのパディング文字は空白スペースです。

サンプル利用状況 ​

関連項目 ​

• rjust: 文字列を右揃えにし、文字列が指定された長さになるまで空白または指定された文字列でパディングします。

rjust ​

文字列を左揃えにし、文字列が指定された長さになるまで空白または指定された文字/文字列でパディングします。

構文 ​

String.rjust(length,character)

• String - 入力文字列。
• length - 出力文字列の長さ。
• character - （任意）入力文字列をパディングする文字または文字列。 指定しない場合、デフォルトのパディング文字は空白スペースです。

サンプル利用状況 ​

関連項目 ​

• ljust: 文字列を左揃えにし、文字列が指定された長さになるまで空白または指定された文字列でパディングします。

reverse ​

文字列を反転し、文字を逆順に並べ替えます。 大文字と小文字は保持されます。

構文 ​

String.reverse

• String - 入力文字列。

利用例 ​

gsub ​

テキスト文字列の一部を置き換えます。 置き換えられた文字を含む新しい文字列を返します。

構文 ​

String.gsub(find,replace)

• String - 入力文字列。 データピルまたは静的な文字列値を使用できます。
• find - 検索する文字列または正規表現（regex）。 regexには/pattern/構文を使用します。
• replace - 置換文字列。 文字列またはhashを使用して置換を定義できます。

サンプル利用状況 ​

高度なサンプル利用状況 ​

gsubメソッドの高度な利用状況について詳しくは、Rubyドキュメントを参照してください。

仕組み ​

このFormulaは検索と置換に似ています。 2つの入力パラメータを受け取ります:

• 最初の入力: 置き換える予定の文字列。 入力では大文字と小文字が区別されるため、完全一致するすべての出現箇所を見つけるには、大文字または小文字を正しく入力してください。
• 2番目の入力: 最初の入力のすべての出現箇所を置き換える新しい文字列。

関連項目 ​

• sub: 検索語句の最初の出現箇所を置き換えます。

sub ​

文字列内で、最初の入力値の最初の出現箇所を2番目の入力値に置き換えます。 このFormulaでは大文字と小文字が区別されます。大文字と小文字の区別が必要な場合は、比較の前に大文字または小文字で入力してください。

構文 ​

String.sub(find,replace)

• String - 入力文字列。 データピルまたは静的な文字列値を使用できます。
• find - 検索する文字列または正規表現（regex）。 regexには/pattern/構文を使用します。
• replace - 置換文字列。 文字列またはhashを使用して置換を定義できます。

サンプル利用状況 ​

length ​

空白を含む、入力文字列内の文字数を返します。

構文 ​

String.length

• String - 入力文字列。

利用例 ​

slice ​

文字列の部分セグメントを返します。

構文 ​

String.slice(start,end)

• String - 入力文字列。
• start - 部分セグメントの返却を開始する文字列のインデックス。 文字列は0から始まるインデックスです。
• end - （任意）返す文字数。 指定しない場合、Formulaは1文字のみを返します。

サンプル利用状況 ​

仕組み ​

Formulaは文字列の部分セグメントを返します。 2つのパラメータを受け取ります。最初のパラメータは、文字列のどの部分から返却を開始するかを決定するインデックスです。 文字列の最初の文字はインデックス0に対応します。 負の数は最後の文字から始まるため、インデックス-1は文字列内の最後の文字です。 2番目のパラメータは、返す文字数を決定します。 最初のパラメータのみを渡すと、1文字が返されます。

scan ​

取得するregexパターンについて文字列をスキャンし、配列を返します。

構文 ​

String.scan(pattern)

• String - 入力文字列。
• regex pattern - 検索するregexパターン。

サンプル利用状況 ​

encode ​

エンコードされた文字列を返します。

構文 ​

String.encode(encoding)

• String - 入力文字列。
• encoding - エンコーディングの名前（例: Windows-1252）。 Rubyエンコーディングの詳細については、Ruby Programming/Encoding Wikibooksの記事を参照してください。

サンプル利用状況 ​

transliterate ​

非ASCII文字をASCII近似に置き換えます。 近似が存在しない場合、デフォルトで'?'の置換文字を使用します。

構文 ​

String.transliterate

• String - 入力文字列。

サンプル利用状況 ​

• parameterize: 文字列内の特殊文字を置き換えます。

テキストの大文字小文字操作 ​

このセクションでは、単語の特定の部分の大文字と小文字を変更できるFormulaについて説明します。

capitalize ​

入力文字列を文の大文字小文字形式に変換します。この形式では、文字列の最初の文字は大文字になり、他のすべての文字は小文字になります。

構文 ​

String.capitalize

• String - 入力文字列。

サンプル利用状況 ​

titleize ​

入力文字列をタイトルケースに変換します。この形式では、各単語の最初の文字は大文字になり、他のすべての文字は小文字になります。

構文 ​

String.titleize

• String - 入力文字列。

サンプル利用状況 ​

upcase ​

テキストを大文字に変換します。

構文 ​

String.upcase

• String - 入力文字列。

サンプル利用状況 ​

仕組み ​

このFormulaは小文字を検索し、大文字に置き換えます。

関連項目 ​

• downcase: テキストを小文字に変換します。
• capitalize: テキストを文の大文字小文字形式に変換します。
• titleize: テキストをタイトルケースに変換します。

downcase ​

テキストを小文字に変換します。

構文 ​

String.downcase

• String - 入力文字列。

サンプル利用状況 ​

仕組み ​

このFormulaは大文字を検索し、小文字に置き換えます。

関連項目 ​

• upcase: テキストを大文字に変換します。
• capitalize: テキストを文の大文字小文字形式に変換します。
• titleize: テキストをタイトルケースに変換します。

quote ​

文字列を引用符で囲み、'（一重引用符）文字をエスケープします

構文 ​

String.quote

• String - 入力文字列。

サンプル利用状況 ​

配列への変換と戻し ​

このセクションでは、文字列を配列に操作する方法を示します。

split ​

このFormulaは、指定された文字で文字列を分割し、文字列の配列を返します。

構文 ​

String.split(char)

• String - 入力文字列値。 データピルまたは静的な値を使用できます。
• char - （任意）テキストを分割する文字。 これでは大文字と小文字が区別されます。 文字が定義されていない場合、デフォルトでは文字列は空白で分割されます。

サンプル利用状況 ​

仕組み ​

このFormulaは、入力文字列内で指定された文字を検索します。 見つかるたびに、入力は新しい文字列に分割されます。

関連項目 ​

• strip: 入力文字列の周囲の空白を削除します。
• slice: 文字列の部分セグメントを返します。
• match: 入力文字列で特定のパターンを確認します。
• join: リスト項目を1つの文字列に結合します。

bytes ​

指定された文字列のバイト配列を返します。

構文 ​

String.bytes

• String - 入力文字列。

サンプル利用状況 ​

bytesize ​

指定された文字列の長さをバイト単位で返します。

構文 ​

Input.bytesize

• Input - 任意の入力文字列。

サンプル利用状況 ​

byteslice ​

長さではなく、指定されたバイトの部分文字列を返します。 場合によっては、日本語や中国語などの非ASCII文字は複数のバイトを使用することがあります。

構文 ​

Input.byteslice(0,4)

• Input - 任意の入力文字列。

サンプル利用状況 ​

他のデータ型の文字列への変換 ​

to_s ​

数値や日付などの非文字列データ型を文字列（テキスト）データ型に変換します。

構文 ​

Input.to_s

• Input - 任意の入力データ。 数値、配列、オブジェクト、または日時のデータ型を使用できます。

サンプル利用状況 ​

仕組み ​

このFormulaは、入力データの文字列表現を返します。

関連項目 ​

• to_f: データをfloat（数値）データ型に変換します。
• to_i: データをinteger（整数）データ型に変換します。

ordinalize ​

数値を、1st、2nd、3rd、4thなど、順序付きシーケンス内の位置を示すために使用される序数文字列に変換します。

構文 ​

Input.ordinalize

• Input - 任意の入力数値。

サンプル利用状況 ​

文字列の他のデータ型への変換 ​

to_f ​

データをfloat（数値）データ型に変換します。

構文 ​

Input.to_f

• Input - 数値入力データ。 文字列データ型または整数データ型を使用できます。

サンプル利用状況 ​

仕組み ​

このFormulaは、入力に数値が含まれているかどうかを確認します。 数値が見つからない場合、0を返します。 数値に小数点がない場合、数値に.0が追加されます。

関連項目 ​

• to_i: データをinteger（整数）データ型に変換します。

to_i ​

データを整数（whole number）データ型に変換します。

構文 ​

Input.to_i

• Input - 数値入力データ。 文字列データ型またはfloatデータ型を使用できます。

サンプル利用状況 ​

仕組み ​

このFormulaは、入力に数値が含まれているかどうかを確認します。 数値が見つからない場合、0を返します。 数値に小数点がある場合、小数点以下はすべて省略されます。

関連項目 ​

• to_f: データをfloat（数値）データ型に変換します。

to_country_alpha2 ​

alpha-3国コードまたは国名をalpha-2国コード（最初の2文字）に変換します。

構文 ​

Input.to_country_alpha2

• Input - 任意の入力文字列。

サンプル利用状況 ​

to_country_alpha3 ​

alpha-2国コードまたは国名をalpha-3国コード（最初の3文字）に変換します。

構文 ​

Input.to_country_alpha3

• Input - 任意の入力文字列。

サンプル利用状況 ​

to_country_name ​

alpha-2、alpha-3国コード、または国名をISO3166国名に変換します。

構文 ​

Input.to_country_name

• Input - 任意の入力文字列。

サンプル利用状況 ​

to_currency ​

整数または数値を通貨スタイルに書式設定し、文字列の先頭にデフォルトの通貨記号を追加します。

構文 ​

Input.to_currency

• Input - 任意の入力文字列。

サンプル利用状況 ​

高度なサンプル利用状況 ​

to_currency Formulaの高度な使用方法について詳しく学びます。 これらをカンマ区切りで組み合わせて、目的の通貨形式を実現できます。 例:

"12345.678".to_currency(delimiter: ".", format: "%n %u", precision: 2, separator: ",", unit: "€")

to_currency_code ​

alpha-2、alpha-3国コード、または国名をISO4217通貨コードに変換します

構文 ​

Input.to_currency_code

• Input - 任意の入力文字列。

サンプル利用状況 ​

to_currency_name ​

alpha-3通貨コード、alpha-2/3国コード、または国名をISO4217通貨名に変換します。

構文 ​

Input.to_currency_name

• Input - 任意の入力文字列。

サンプル利用状況 ​

to_currency_symbol ​

alpha-3通貨コード、alpha-2/3国コード、または国名をISO4217通貨記号に変換します。

構文 ​

Input.to_currency_symbol

• Input - 任意の入力文字列。

サンプル利用状況 ​

to_phone ​

文字列または数値をフォーマット済みの電話番号（ユーザー定義）に変換します。

構文 ​

Input.to_phone

• Input - 任意の入力文字列または数値。

サンプル利用状況 ​

to_state_code ​

州名をコードに変換します。

構文 ​

Input.to_state_code

• Input - 任意の入力文字列。

サンプル利用状況 ​

to_state_name ​

州コードを名前に変換します。

構文 ​

Input.to_state_name

• Input - 任意の入力文字列。

サンプル利用状況 ​