文字関数

指定のエンコーディングを使って、BLOBから文字列を作成する。

BLOB（binary large object）

encoding

（オプション）エンコーディングを指定する引用符付き文字列。文字列のデフォルトのエンコーディングはutf-8です。utf-16le、utf-16be、us-ascii、iso-8859-1、ascii~hex、shift-jis、euc-jpもサポートされています。

Blob To Matrix(blob, "type", bytes, "endian", <nCols>)

エンコーディングのオプションのうち、US-ASCIIは、CR、LF、TABなどが含まれるBLOBデータを、特別な考慮をせずに、ASCII文字の文字列に単純に変換します。

エンディアンを表す引数。最初のバイトが最上位、最下位のいずれであるかを示す引用符付き文字列。指定できるパラメータは次のとおりです。

blobのバイトを数値に変換して行列を作成する。

数値のデータ型を示す引用符付き文字列。int、uint、floatのいずれか。

bytes

BLOB内のデータのサイズをバイトで示したもの。1、2、4、8のいずれか。

endian

–

"big"は、最初のバイトが最上位であることを示します（ビッグエンディアン）。

–

"little"は、最初のバイトが最下位であることを示します（リトルエンディアン）。

–

"native"は、コンピュータのネイティブ形式を使用します。

nCols

（オプション）行列の列数を指定する。デフォルト値は1です。

Char(x, <width>, <decimal>)

式または数値。式はExpr()で囲む必要があります。囲まない場合、その評価結果が文字列に変換されます。

width

（オプション）文字列の最大文字数を設定する数値。

decimal

（オプション）文字列に含まれる、小数点以下の最大桁数を設定する数値。

引数widthが引数decimalより優先されます。

Char To Blob(string, <"encoding">)

Char( Pi(), 10, 4)

"3.1416"

Char( Pi(), 3, 4)

"3.1"

文字列を、バイナリデータ（BLOB）に変換する。

（オプション）エンコーディングを指定する引用符付き文字列。BLOBのデフォルトのエンコーディングはutf-8です。utf-16le、utf-16be、us-ascii、iso-8859-1、ascii~hex、shift-jis、euc-jpもサポートされています。

Char To Hex(value, <"integer" | "encoding">)

BLOBを印字可能な形式に変換する際、\（および~ " !と、ASCIIの印字不能な範囲の文字）は、16進数表記に変換されます（バックスラッシュの場合は、~5C）。

x = Char To Blob( "abc\def\!n" );

y = Blob To Char( x, encoding = "ASCII~HEX" );

If(

	y == "abc~5Cdef~0A", "JMP 12.2以降のバージョンの動作",

	y == "abc\def~0A", "JMP 12.2より前のバージョンの動作"

);

"JMP 12.2以降のバージョンの動作" // 出力

Hex(value, <"integer" | "encoding">)

指定のエンコーディングを使って、値を16進数の文字列に変換する。

任意の数値、引用符付き文字列、またはBLOB。

integer

valueが数値の場合、浮動小数点ではなく整数としての16進数を戻す。

encoding

（オプション）エンコーディングを指定する引用符付き文字列。デフォルトのエンコーディングはutf-8です。utf-16le、utf-16be、us-ascii、iso-8859-1、ascii~hex、shift-jis、euc-jpもサポートされています。

Collapse Whitespace("text")

先頭および末尾の空白文字を削除し、文字列内で空白文字が連続している部分は重複を削除する。つまり、Collapse Whitespace関数で2つの連続したスペースを1つのスペースに置換できます。

文字列の場合: 文字列bを文字列aに追加する。どちらの引数も変更されません。

リストの場合: リストbをリストaに追加する。どちらの引数も変更されません。

行列の場合: 行列Aと行列Bを横に連結する。

文字列の場合: 文字列aの後に文字列bを追加した文字列

リストの場合: リストaの後にリストbを追加したリスト

行列の場合: 行列

2つ以上の文字列、文字列変数、リスト、または行列。

3つ以上の引数を取ることができます。追加の文字列は、左から右の順番に文字列の最後に追加されます。行列の場合は、左から右の順番で、横に結合されていきます。

a = "こんにちは"; b = " "; c = "世界"; a || b || c;

"こんにちは世界"

d = {"りんご", "バナナ"}; e = {"桃", "梨"}; Concat( d, e );

{"りんご", "バナナ", "桃", "梨"}

A = [1 2 3]; B = [4 5 6]; Concat( A, B );

[1 2 3 4 5 6]

Concat Items

第 “Concat Items({string1, string2, ...}, <delimiter>})”を参照してください。

文字列の場合: 文字列aに文字列bを追加して、新しくできた連結文字列をaに代入する。

行列の場合: 行列aに行列bを追加して、新しくできた行列をaに代入する。

リストの場合: リストaにリストbを追加して、新しくできたリストをaに代入する。

文字列の場合: 文字列aの後に文字列bを追加した文字列

行列の場合: 行列

リストの場合: リストaの後にリストbを追加したリスト

2つ以上の文字列、文字列変数、行列、またはリスト。第1引数には変数を指定しなければならない

3つ以上の引数を取ることができます。追加の文字列、行列、またはリストは、左から右の順番に文字列の最後に追加されます。

d = {"りんご", "バナナ", "桃", "梨"};

a = "こんにちは"; b = " "; c = "世界"; Concat To( a, b, c ); Show( a );

a = "こんにちは世界";

A = [1 2 3]; B = [4 5 6]; Concat To( A, B ); Show( A );

A = [1 2 3 4 5 6];

d = {"りんご", "バナナ"}; e = {"桃", "梨"}; Concat to(d,e); Show( d );

Contains(whole, part, <start>)

部分（part）が全体（whole）の中に含まれているかどうかを判断する。

partが見つかったとき、リスト、文字列、および名前空間の場合はpartが最初に見つかった位置の数値を戻し、連想配列の場合は1を戻す。

partが見つからないときは、すべてのケースで0が戻されます。

whole

文字列、リスト、名前空間、または連想配列。

part

文字列または名前空間の場合、文字列wholeの一部の文字列。リストの場合、リストwholeにある項目。連想配列の場合、マップwholeにあるキー。

start

（オプション）文字列whole内での検索開始位置を表す数値引数。全体（whole）の中。なお、startが負の場合、Containsは、wholeの長さからstartを差し引いた位置から、whole内のpartを逆方向に検索します。連想配列の場合、startは意味がなく、無視されます。

この例では、項目"Katie"がリストの1番目にあるので、1が戻されます。

nameList={"Katie", "Louise", "Jane", "Jaclyn"};

r = Contains(nameList, "Katie");

Contains Item(x, <item | list | pattern>, <delimiter>)

多重応答を認識し、指定された項目、リスト、パターン、区切り文字を検索する。この関数は、多重応答の尺度または列プロパティを持つ列に対して使用できます。

引数xのテキスト内にある単語のいずれかと、単語（item）、単語リスト（list）の中の1つ、またはパターン（pattern）がマッチするかどうかを、ブール値で戻す。テキスト内の単語は、オプションで指定された区切り文字（delimiter）で区切られます。デフォルトの区切り文字はカンマ（","）です。なお、テキスト（x）から抽出された各単語の末尾にある空白は削除されます。

Ends With(string, substring)

次の例では、“pots”およびそれに続くカンマを検索して、結果を出力します。

x = "Franklin Garden Supply is a leading online store featuring garden decor, statues, pots, shovels, benches, and much more.";

b = Contains Item( x, "pots", "," );

If( b,

	Write( "指定された項目が見つかりました。"  ), Write( "一致しません。" )

);

指定された項目が見つかりました。

文字列（string）の最後に部分文字列（substring）があるかどうかを判断する。

文字列（string）が部分文字列（substring）で終わっていれば1、そうでなければ0

引用符付き文字列、または文字列変数。リストでも可。

string

substring

引用符付き文字列、または文字列変数。リストでも可。

等価表現

Right(string, Length(substring)) == substring

Hex(value, <"integer" | encoding="enc")

第 “Char To Hex(value, <"integer" | "encoding">)”を参照してください。

Hex To Blob(string)

16進数の文字列（string）（空白を含む）から、BLOB（binary large object）を作成する。

Char To Blob("JMP", "ascii~hex")

Hex To Blob( "4A4D50" );

Hex To Char(string, <encoding>)

16進数の文字列（string）を、整数、もしくは、浮動小数点に変換します。

Hex To Char( "30" )の結果は“0”です。

文字列のデフォルトのエンコーディングはutf-8です。utf-16le、utf-16be、us-ascii、iso-8859-1、ascii~hex、shift-jis、euc-jpもサポートされています。

Hex To Number(string)

16進数の文字列（string）を、整数、もしくは、浮動小数点に変換する。

Hex To Number( "80" );

128

16進数は、整数、もしくは、IEEE 754の64ビット形式の浮動小数点数として、変換されます。

バイト間（つまり数字のペア）およびバイトの中央に空白文字が含まれていてもかまいません
（例：FF 1919、F F1919）。

Insert

第 “Insert(source, item, <position>)”を参照してください。

Insert Into

第 “Insert Into(source, item, <position>)”を参照してください。

Item(n, string, <delimiters>)

引数の文字列（string）からn番目の単語を抽出する。区切り文字（delimiters）を指定すると、文字列を各単語に区切る際に、その文字が使われます。デフォルトの区切り文字はスペースです。複数の区切り文字を指定した場合、指定したすべての文字が区切り文字とみなされます。

Left(string, n, <filler>)

Item()は、区切り文字1つ1つが個別の区切り文字として使われる以外はWord()と同じ。Word()では、連続した複数の区切り文字が1つの区切り文字として扱われます。

Item( 4,"the  quick brown fox" , ", " ); // "quick"の前のスペースは2つ

"brown"

Word( 4,"the  quick, brown fox", ", " );

"fox"

Left(list, n, <filler>)

元の文字列（string）から、右からn文字の文字列を取り出す。もしくは、元のリスト（list）から、最初のn個のリスト項目を取り出す。文字列（string）の長さがn個よりも短い場合は、fillerに指定された文字列が右側に補充されます。

Length(string)

引用符付き文字列（string）の文字数（長さ）を計算する。

Lowercase(string)

Munger(string, offset, find|length)

引用符付き文字列（string）内に現れる文字をすべて小文字に変換する。

Munger(string, offset, find, replace)

引用符付き文字列（string）に文字を挿入したり、削除したりして、新しい文字列を作る。また、引数の指定方法により、文字列の一部を取り出す、また、ある文字列が何文字目に含まれているかを計算する、といった処理を実行できます。

offsetは、string内での検索開始位置を示す整数です。なお、ある検索文字列において、その先頭位置よりoffsetが大きい場合、その検索文字列は検索に含まれません。また、offsetがstringの長さより大きい場合、offsetは、（stringの長さ+1）に設定されます。

Num(string)

Regex("source", "pattern", (<replacementString>, <GLOBALREPLACE>), <format>, <IGNORECASE>)

文字列を数値に変換する。

ソース文字列（source）内でパターン(pattern)を検索する。

一致するテキストを文字列または数値で戻す。一致するテキストが見つからない場合は欠測値を戻します。

（オプション）一致したグループへの前方参照。デフォルトは、一致した文字列全体である/0。/nはn番目にマッチしたものを戻します。

IGNORECASE

（オプション） IGNORECASEを指定しない場合、大文字と小文字が区別される。

GLOBALREPLACE

置換文字列と一緒に使用するオプション。一致したものがすべて見つかるまで、ソース文字列（source）に正規表現を適用します。

Remove

第 “Remove(source, position, <n>)”を参照してください。

Remove From

第 “Remove From(source, position, <n>)”を参照してください。

Repeat(source, a)

Repeat(matrix, a, b)

Right(string, n, <filler>)

sourceを、a回、繰り返して連結した結果を戻す。または、matrixをa回だけ縦に結合し、それをb回だけ横に結合した行列を戻します。sourceはテキスト、またはリスト、matrixは行列です。

Reverse

第 “Reverse(source)”を参照してください。

Reverse Into

第 “Reverse Into(source)”を参照してください。

Right(list, n, <filler>)

Starts With(string, substring)

元の文字列（string）から、右からn文字の文字列を取り出す。もしくは、元のリスト（list）から、最後のn個のリスト項目を取り出す。文字列（string）の長さがn個よりも短い場合は、fillerに指定された文字列が左側に補充されます。

Shift

第 “Shift(source, <n>)”を参照してください。

Shift Into

第 “Shift Into(source, <n>)”を参照してください。

文字列（string）の冒頭に部分文字列（substring）があるかどうかを判断する。

文字列（string）が部分文字列（substring）で始まっていれば1、そうでなければ0

Substr(string, start, length)

string

引用符付き文字列または文字列変数。リストでも可。

substring

引用符付き文字列または文字列変数。リストでも可。

等価表現

Left(string, Length(substring)) == substring

Substitute

第 “Substitute(string, substring, replacementString, ...)”を参照してください。

Substitute Into

第 “Substitute Into(string, substring, replacementString, ...)”を参照してください。

第2引数（start）で指定した位置から第3引数（length）で指定した文字数の文字を、第1引数（string）の文字列から抽出する。第1引数には、文字列を指定してください。開始位置と文字数の引数は、整数です。

1文字目から5文字を読み取り、残りの文字を無視して「Katie」を戻します。

この例では、ファーストネームを抽出します。

Substr( "Katie Layman", 1, 5 );

Titlecase("text")

文字列をタイトルケースに変換する。つまり、文字列内の各単語の先頭を大文字にし、残りを小文字にします。

Titlecase( "veronica layman ")

下記の文字列が戻されます。

"Veronica Layman"

Trim("text",<left|right|both>)

Trim Whitespace("text",<left|right|both>)

第2引数は、空白文字を文字列の左側（left）、右側（right）、または両側（both）のどちらから削除するかを指定します。第2引数が指定されない場合、両側から空白文字が削除されます。

次のコマンドを見てみましょう。

Trim( "  John    ", both )

下記の文字列が戻されます。

"John"

Uppercase(string)

Word(n, "text", <"delimiters">)

引用符付き文字列（string）内に現れる小文字をすべて大文字に変換する。

引数の文字列（text）からn番目の単語を抽出する。区切り文字（delimiters）を指定すると、文字列を各単語に区切る際に、その文字が使われます。デフォルトの区切り文字はスペースです。複数の区切り文字を指定した場合、指定したすべての文字が区切り文字とみなされます。

この例では、ラストネームを戻します。

Word( 2, "Katie Layman" );

XPath Query( xml, "xpath_expression")

Word()関数とItem()関数は同じです。ただし、Item()関数は、区切り文字が連続している時にそれらを1つ1つカウントしますが、Word()関数は連続している区切り文字を1文字の区切り文字として扱います。

Item( 4,"the  quick brown fox" ); // "quick"の前のスペースは2つ

"fox"

Word( 4,"the  quick brown fox" );

"brown"

Words

第 “Words("text", <"delimiters">)”を参照してください。