TJS2 では、文字列は擬似的に
String クラスのオブジェクトということになっていますが、String クラスは存在していませんし、実際に String クラスのオブジェクトというわけではありません ( ただし 文字列に対して typeof 演算子を使うと "String" を返します )。
しかし 文字列をオブジェクトと見立てて、いくつかのメソッドやプロパティが使用可能になっています。
length プロパティは、文字列の長さを返します。メソッドではなくてプロパティですので注意してください。ただし、このプロパティへの値の代入はできません。
TJS では内部的に文字をすべて
UNICODE で扱っていますので、全角文字も 1 文字、半角文字も 1 文字と数えられます。
例:
var str = "abc漢字";
var n = str.length;
var n = "abc漢字".length;
数値をプロパティとして間接指定すると、その文字位置にある文字にアクセスできます。
たとえば、str が文字列あるいは文字列を表す式だとすると、str[0] は先頭の一文字を表す文字列になります。
数値が文字列よりも長い位置や、負の場合は例外が発生します ( ただし文字列の最後の文字は 空文字 が返されます )。
代入式を生成することはできません。
例:
var str = "abcdef";
var c = str[0];
var c = str[2];
str[3] = 'A';
var c = str[100];
var c = str[6];
charAt メソッドは、文字列の指定位置で指定された位置の文字を返します。 '数値' プロパティと同様の動作をしますが、範囲外の場合は常に空文字列を返します (例外を出しません)。
構文 : charAt(<文字位置>)
例:
var str = "abcdef";
var c = str.charAt(3);
indexOf メソッドは、部分文字列の位置を返します。
構文 : indexOf(<部分文字列>[,<検索開始位置>])
文字列から、<部分文字列> を<検索開始位置>から検索し、最初に見つかった位置を返します。 0 が返されれば文字列の先頭です。-1 が返されたときは見つからなかったときです。<検索開始位置>を省略すると、文字列の先頭からの検索になります。
例:
var str = "abcdefghijkl";
var n = str.indexOf("fgh");
var n = str.indexOf("xyz");
このメソッドに引数はありません。
toLowerCase は、文字列のアルファベットを小文字にした文字列を返します。
全角文字は変換されません。
これらのメソッドは、もとの文字列には影響を与えません。
例:
var lwr="ABCDEF".toLowerCase();
Note
現バージョンの TJS2 では 文字コード 0x80 未満の文字に対してのみ変換を行います。
このメソッドは toLowerCase と逆で、小文字のアルファベットを大文字にした文字列を返します。
substring メソッドは、文字列の部分文字列を返します。
構文 : substring(<開始文字位置>[,<文字数>])
文字列の、<開始文字位置>から<文字数分>の部分文字列を返します。元の文字列に影響は与えません。<文字数> を省略すると、<開始文字位置> 以降の文字列がすべて返されます。
JavaScript の同メソッドとは引数の意味が違うので注意してください。
例:
var ss="abcdefghijkl".substring(3,3);
sprintf メソッドは、文字列を書式化します。
構文 : sprintf(引数, 引数, ....)
文字列を書式文字列と見なし、C言語における sprintf 同様のテキストのフォーマッティングを行った文字列を返します。元の文字列には影響を与えません。
例:
var formatted = "%04X %c %5d".sprintf(v1, v2, dic[v1]);
replace メソッドは、文字列の置き換えを行います。
構文 : replace(<パターン>, <置き換え後文字列>)
正規表現パターンに従って文字列の置き換えを行い、置き換えを行ったあとの文字列を返します。元の文字列には影響を与えません。
動作については
RegExp クラス の replace メソッドを参照してください。
split メソッドは、文字列を分割します。
構文 : split(<パターン/デリミタ集合>, <(予約)>, <空の要素を無視するか=false>)
文字列を分割した結果が格納された配列オブジェクトを返します。
Array クラス の split メソッドも参照してください (引数の順番に注意してください)。
escape メソッドは、文字列を、TJSの文字列即値内で表現可能な形式に変換します。\ や " などの記号はすべて \ 記号を用いて特殊な用途として解釈されなくされます (エスケープされます)。
構文 : escape()
エスケープされた文字列を返します。元の文字列には影響を与えません。
例:
var escaped = str.escape();
trim メソッドは、文字列の先頭と最後の空白を取り除いた文字列を返します。元の文字列には影響を与えません。
先頭と最後の空白とは、文字コードがU+0001縲弑+0020の文字を指します。つまり、ASCII制御文字なども含まれますが、いわゆる全角の空白は含みません。
連続して先頭または最後にこれらの空白があった場合は、すべて取り除かれます。
構文 : trim()
先頭と末尾の空白文字が削除された文字列を返します。元の文字列には影響を与えません。
例:
var str = " Hoge ".trim();
reverse メソッドは、文字の並びを逆転した文字列を返します。元の文字列には影響を与えません。
現バージョンのTJS2では、UTF-16のうちサロゲートペアを含む文字列の動作は保証しません。
構文 : reverse()
文字の並びを逆転した文字列を返します。元の文字列には影響を与えません。
例:
var str = "Hoge".reverse();
repeat メソッドは、指定した回数だけ文字列を繰り返した文字列を返します。元の文字列には影響を与えません。
構文 : repeat(count)
count個、この文字列を繰り返した文字列を返します。元の文字列には影響を与えません。
例:
var str = "Hoge".repeat(3);