テキストおよびデータ操作

SenseTalkには、強力なテキスト処理能力が備わっています。 チャンク式で説明するように、SenseTalkのチャンク式は、テキスト文字列の特定の部分にアクセスしたり、操作したりするためのパワフルかつ直観的な手段を提供します。 また、テキストに関する情報を入手したり、テキストとその他のデータフォーマット間で変換を行ったり、高度なテキスト操作を行ったりするための多くのコマンドと関数を利用できます。 このようなアクションを実行するためのコマンドと関数について、以下で詳しく説明します。

capitalized()関数

挙動：capitalized関数は、各単語の最初の文字が大文字で始まるテキストを返します。

構文：

例：

関連：

• uppercase()関数
• lowercase()関数

charToNum()関数

挙動：パラメータの最初の文字を表す数値コード（Unicode）を返します。

構文：

例：

関連：

• numToChar()関数

deleteコマンド

挙動：deleteコマンドは、コンテナ内のターゲットテキスト文字列の大量のテキストや1つ以上のオカレンスを削除します。 この最も簡潔なフォームにおいて、本コマンドは大文字と小文字に関係なく、ターゲットテキストの各オカレンスを削除します。 より高度なオプションを使用すると、削除するチャンクの場所で特定したり、ターゲット文字列のオカレンスの数を指定（あるいは特定のオカレンスを指定）したり、正確な大文字と小文字のマッチングを指定することが可能です。

deleteコマンドの最初のフォームでは、チャンクは、削除するコンテナの一部を描写する任意のチャンク式とすることができます。 詳細情報は、チャンク式を参照してください。

deleteコマンドの2つ目のフォームでは、targetTextを定義するいずれかのオプションを1つと、削除を行うcontainerを指定する必要があります。 大文字・小文字を区別するオプションは任意で使用できます。 使用するオプションは、タイプごとに1つしか指定できないとはいえ、任意の順番で指定できます。

構文：

オプション：

例：

例：

例：

例：

例：

関連：

• delete variableコマンド
• delete fileコマンド

excludingItems()関数

挙動：excludingItems関数は、リスト1からリスト2に存在する値を除外したすべての値を含むリストを返します。

構文：

例：

format()関数

挙動：テンプレートの文字列によって定義される、フォーマットされた任意の個数の値のテキスト表現を返します。 テンプレートは、特殊なフォーマットコードが混在したテキストで構成され、定義された小数の桁数でフォーマットされる数値や、定義された最短の長さを満たすために追加スペースでフォーマットされるテキスト値などを指定します。

構文：

例：

例：

例：

関連：

• merge()関数

globallyUniqueString()関数

挙動：globallyUniqueString関数は、呼び出されるたびに固有の文字列を提供します。 globallyUniqueString()を呼び出すことで、識別子やキー、ファイル名として使用される固有の文字列を入手できます。 この値は、システム、アプリケーションインスタンス、および個々の関数呼び出しにわたって一意の値となります。

構文：

例：

例：

insert コマンド、pushコマンド

挙動：リストの末尾、またはリストの特定のアイテムの前後に値または値のリストを挿入します。

構文：

例：

例：

例：

例：

例：

intersection()関数

挙動：intersection関数は、リスト1とリスト2の両方に存在するすべての値を含むリストを返します。 重複する値は、最終的なリストからすべて削除されます。

構文：

例：

joinコマンドとjoin()関数

挙動：join（またはこのシノニムのcombine）コマンドは、指定された区切り文字を使用して、リストのアイテムまたはプロパティリストのプロパティを単一のテキスト値に組み入れます。 ソース値がコンテナの場合は、そのコンテナは本コマンドの結果として生じるテキスト文字列を受け取ります。 ソース値がコンテナではない場合は、変数itが、ソース値の要素の結合の結果として生じるテキストを受け取ります。 with quotesオプションは、各値を引用符で囲むのに使用できます。

関数として呼び出す場合は、式の一部として使いやすくするために、join（またはcombine）は結合されたテキスト値を返します。

コマンド構文：

関数構文：

例：

例：

例：

例：

例：

関連：

• splitコマンドとsplit()関数
• joined by演算子

keepCharacters()関数

挙動：指定した英数字や文字セットを除くすべての文字をテキストから削除します。 本関数は、1～2個のパラメータを使用します。 最初のパラメータは、フィルタ処理されるソーステキスト値です。 2番目（オプション）のパラメータは、ソーステキスト内で保持される文字セットを定義するテキスト文字列です。 2番目のパラメータを指定しない場合は、デフォルトで文字と数字が保持されます。 本関数は大文字と小文字を区別することに注意してください。

構文：

例：

length()関数

挙動：テキスト内の文字数を返します。

構文：

例：

例：

lowercase()（またはtoLower()）関数

挙動：lowercase（およびこのシノニムのtoLower）関数は、すべて小文字（大文字ではない）に変換された式を返します。

構文：

例：

関連：

• uppercase関数
• capitalized関数

merge()関数

挙動：ソーステキストをスキャンし、mergeデリミタで囲まれた式の評価と代入を行い、結合されたテキストを返します。 標準的なmergeデリミタは、二重角括弧（[[と]]）です。 [[と]]で囲まれたソーステキスト内の式は、その値に置き換えられます。 式は現在の文脈において評価されるため、merge式内の任意のローカル変数やグローバル変数は、merge関数を呼び出したハンドラ内に存在するのと同じ値を保持します。

mergeデリミタ間のテキストには、シンプルな式のほかに、SenseTalkステートメントを組み込むことができます。 これは、テキストの一部にrepeatループを組み込む場合などのように、非常に強力になり得ます。

最後の2つのパラメータはオプションであり、source文字列のみが必須となります。 デリミタ1およびデリミタ2を指定すると、これらがmergeデリミタとして[[と]]の代わりに使用されます。 デリミタ1のみを指定すると、その値がデリミタの初めと終わりとして使用されます。 the evaluationContextグローバルプロパティを GlobalまたはUniversalに設定すると、変数は結合プロセス中にローカルではなく、グローバルまたはユニバーサルとして処理されます。

merge関数を呼び出すための簡易表現として、引用符で囲まれた文字列の前に!を使用できます。

構文：

例：

例：

例：

例：

例：

number of演算子

挙動：本演算子は、単語ofの前に変数ではなく、リテラル数を必要とします。 本演算子は、分数の数値や単位に役立てることができます。 値が数またはリストである場合、値にはその数値が掛けられます。 それ以外の場合は、number of演算子は、repeated演算子のように値に繰り返しをもたらします。

構文：

例：

例：

例：

例：

例：

numToChar()関数

挙動：所定の数値コード（Unicode）で表現される文字を返します。

構文：

例：

関連：

• charToNum()関数

offset()、range()、everyOffset()、everyRange()関数

挙動：offset()関数は、ソーステキスト内のターゲットテキストのオフセット位置、またはソースリスト内のターゲットの値もしくは値のリストのオフセットを返します。 range()関数は、同様に機能しますが、ターゲットがソース内で検出される場所の範囲（開始位置と終了位置）を返します。 検索中のターゲット値がソース内で検出されない場合は、値0（オフセット用）または空の範囲の0～0が返されます。 offset()またはrange()に対してオプションのパラメータを利用すると、特定のポイント以降の従属文字列のオカレンスを検出したり、検索が大文字と小文字を区別するかどうかを管理したり、ソース文字列の末尾から逆方向に検索することが可能になります。 オプションのパラメータであるlocationおよびpositionは、offset関数またはrange関数において、afterまたはbeforeの後に置かれます。

everyOffset()関数とeveryRange()関数は、これらに対応する関数と同等に機能しますが、ターゲットがソース内で検出される場所のすべてのオフセットまたはすべての範囲のリストを返します。

これらすべての関数は、通常、直接呼び出すのではなく、英語のような自然言語のフレーズを使用して呼び出されます。 自然言語は、英語のようなフレーズとして、offset式またはrange式を記述するのにも利用できます。

構文：

自然構文：

例：

例：

例：

例：

例：

例：

例：

popコマンド

挙動：popコマンドは、リストから最後の値を取り除き、その値を変数に格納します。

パラメータ：

構文：

例：

pullコマンド

挙動：pullコマンドは、リストから最初の値を取り除き、その値を変数に格納します。

パラメータ：オプションで、変数に格納する値を指定できます。

構文：

例：

replaceコマンド

挙動：replaceコマンドは、コンテナ内の古い（ターゲット）テキスト文字列の1つ以上のオカレンスを、新しい（置換）テキスト文字列に置き換えます。 この非常にシンプルなフォームにおいて、本コマンドは大文字と小文字に関係なく、古いテキストのオカレンスをすべて新しいテキストに置き換えます。 より高度なオプションを使用すると、置き換えられる古いテキストのオカレンス数（または特定のオカレンス）を指定したり、正確な大文字と小文字のマッチングを指定することが可能になります。

パラメータ：beyondPosition、caseSensitiveおよびreverseパラメータはオプションであり、（検索する）target文字列または値と、（検索先の）source文字列またはリストのみが必須です。

beyondPositionを指定する場合は、検索はその位置以降のソース文字列の次の文字（またはソースリストの次のアイテム）から開始されます。 ソースの先頭から検索するには、値ゼロを使用します（デフォルト）。 本関数によって返される値は常に、ターゲット文字列がソース文字列内で検出された位置（または範囲）か、検出されなかった場合はゼロとなります。 負の数のbeyondPositionを指定すると、ソースの末尾を基準とする位置が表されます。 この場合は、戻り値もソースの末尾からのオフセットを示す負の数として与えられます。

caseSensitiveパラメータ（指定する場合）は、trueまたはfalseとして評価されます。 本パラメータがtrueの場合は、検索は大文字と小文字が完全に一致するマッチングのみを検出します。 デフォルト（パラメータを指定しない場合）はfalseとなります。 自然構文を使用する場合は、検索はconsidering caseを指定すると大文字と小文字が区別され、ignoring caseを指定すると大文字と小文字は区別されません。 デフォルトでは、大文字と小文字は区別されません。

reverseパラメータ（指定する場合）は、trueまたはfalseとして評価されます。 自然構文内でのbeforeの使用は、reverseパラメータをtrueに設定するのに相当します。 本パラメータがtrueの場合は、ソースの末尾（またはbeyondPositionの前の文字）から先頭方向に向かう逆検索が行われます。 デフォルト（パラメータを指定しない場合）はfalseとなります。

構文：

オプション：

例：

例：

例：

例：

repeated演算子

挙動：指定された長さを上限として、所定の回数だけ繰り返されるテキストの文字列を作成したり、繰り返されたリストを作成します。

構文：

例：

例：

例：

例：

rtfToText()関数

挙動：RTFフォーマットのリッチテキストをプレーンテキストに変換します。 richTextの値は、RTFフォーマットでエンコードされたテキストである必要があります。 rtfToText関数は、すべてのフォーマット情報を削除し、richTextからプレーンテキストのコンテンツだけを返します。

構文：

例：

sortコマンド、sorted演算子

挙動：sortコマンドは、コンテナのコンテンツをソートします。 コンテナのコンテンツは、ソートされたコンテンツで置き換えられます。

sorted演算子は値のコンテンツをソートし、コンテナ内に格納できるソート済みの値、またはより長い式の一部として使用できるソート済みの値を生成します。

構文：

オプション：

例：

例：

例：

splitコマンドとsplit()関数

挙動：splitコマンドは、指定された区切り文字でテキストを区切ることで、テキストを値のリストまたはキーと値のプロパティリストに分割します。 ソース値がコンテナの場合は、本コマンドの結果として、そのコンテナはリスト（またはプロパティリスト）となります。 ソース値がコンテナではない場合は、変数itが、ソース値の分割によって生じるリスト（またはプロパティリスト）を受け取ります。

関数として呼び出す場合は、式の一部として使いやすくするために、splitは結果のリストまたはプロパティリストを返します。

コマンド構文：

関数構文：

例：

例：

例：

例：

関連：

• joinコマンドとjoin()関数
• split by演算子

standardFormat()関数

挙動：standardFormat関数は、アーカイブに適したフォーマットで、任意の値のテキスト表現を返します。 任意のタイプの値において、本関数はパラメータとしてvalue()関数に使用できるテキスト値を返し、元の値を取り出します。

構文：

例：

例：

例：

例：

例：

関連：値の変換におけるthe defaultQuoteFormat、the listFormatおよびthe propertyListFormatグローバルプロパティ。

text()、asText() 関数

挙動：text関数（またはasText関数）は、そのパラメータ値をテキストフォーマットで返します。

構文：

例：

例：

関連：

• 値の変換
• as演算子

textDifference()関数

挙動：2つの語または語句間の「レーベンシュタイン距離」を計算します。 これは、2つのテキスト文字列が互いにどれほど異なるかを測定する方法です。 2つの値が等しい場合は、それらのtextDifferenceはゼロとなります。 1つの文字を別の文字に変更するか、挿入または削除して、1つの文字列を別の文字列に変更する場合は、その差異は1となります。 数字が大きくなればなるほど、2つの文字列間の違いが大きいことが示されます。 返される最も大きな数はより長い方の文字列の長さであり、これが返された場合は、2つの文字列が全く異なることが示されます。 本関数は、caseSensitiveグローバルプロパティがtrueに設定されていない限り、大文字と小文字を区別しません。

構文：

例：

例：

例：

trim()、trimStart()、trimEnd()、trimAll() 関数

挙動：テキスト値から先頭と末尾の空白（またはその他の文字）を削除します。 これらの関数は、1～2個のパラメータを使用します。 最初のパラメータは、トリムされるソーステキスト値となります。 2番目（オプション）のパラメータは、ソーステキストから削除する文字セットを定義するテキスト文字列となります。 2番目のパラメータを省略する場合は、デフォルトで空白および改行文字がトリムされます。

trim関数は、ソーステキスト値の先頭と末尾から空白または特定の文字を削除します。

trimStart関数は、ソースの先頭のみから空白または特定の文字を削除します。

trimEnd関数は、ソースの末尾のみから空白または特定の文字を削除します。

trimAll関数は、ソーステキストのあらゆる場所からすべての空白または特定の文字を削除します。

構文：

注：空白と特定の文字の両方を削除したい場合は、2番目のパラメータにおいて、文字セットに空白を含める必要があります。

例：

例：

例：

例：

例：

例：

union()関数

挙動：union関数は、リスト1のすべての値とリスト2のすべての値を含むリストを返します。 重複する値は、最終的なリストからすべて削除されます。

構文：

例：

uniqueItems() 関数

挙動：uniqueItems関数は、重複値を除いたlistValueのすべての一意の値を含むリストを返します。

構文：

例：

uppercase()（またはtoUpper()）関数

挙動：uppercase関数とこのシノニムのtoUpper関数は、すべて大文字に変換される式を返します。

構文：

例：

関連：

• lowercase()関数
• capitalized()関数

 

This topic was last updated on 2月 01, 2019, at 11:13:23 午前.

Eggplant.io | Documentation Home | User Forums | Support | Copyright © 2019 Eggplant