# 文字列に対する操作

TJS2 では、文字列は擬似的に String クラスのオブジェクトということになっていますが、String クラスは存在していませんし、実際に String クラスのオブジェクトというわけではありません ( ただし 文字列に対して typeof 演算子を使うと "String" を返します )。
しかし 文字列をオブジェクトと見立てて、いくつかのメソッドやプロパティが使用可能になっています。

# length

length プロパティは、文字列の長さを返します。メソッドではなくてプロパティですので注意してください。ただし、このプロパティへの値の代入はできません。
TJS では内部的に文字をすべて UNICODE で扱っていますので、全角文字も 1 文字、半角文字も 1 文字と数えられます。
`例:
var str = "abc漢字";
var n = str.length; // n には 5 が代入される
var n = "abc漢字".length; // これも同じく 5 が代入される
`

# '数値' プロパティ

数値をプロパティとして間接指定すると、その文字位置にある文字にアクセスできます。
たとえば、str が文字列あるいは文字列を表す式だとすると、str[0] は先頭の一文字を表す文字列になります。
数値が文字列よりも長い位置や、負の場合は例外が発生します ( ただし文字列の最後の文字は 空文字 が返されます )。
代入式を生成することはできません。
`例:
var str = "abcdef";
var c = str[0]; // 'a' が c に代入される
var c = str[2]; // 'c' が c に代入される
str[3] = 'A'; // 代入式は生成できないのでエラーになる
var c = str[100]; // c 値が範囲外なのでエラーになる
var c = str[6]; // 空文字 '' が代入される
`

# charAt

charAt メソッドは、文字列の指定位置で指定された位置の文字を返します。 '数値' プロパティと同様の動作をしますが、範囲外の場合は常に空文字列を返します (例外を出しません)。
`構文 : charAt(<文字位置>)
`
`例:
var str = "abcdef"; var c = str.charAt(3); // 'd' が c に代入される`

# indexOf

indexOf メソッドは、部分文字列の位置を返します。
`構文 : indexOf(<部分文字列>[,<検索開始位置>])
`
文字列から、<部分文字列> を<検索開始位置>から検索し、最初に見つかった位置を返します。 0 が返されれば文字列の先頭です。-1 が返されたときは見つからなかったときです。<検索開始位置>を省略すると、文字列の先頭からの検索になります。
`例:
var str = "abcdefghijkl";
var n = str.indexOf("fgh"); // n には 5 が代入される
var n = str.indexOf("xyz"); // n には -1 が代入される
`

# toLowerCase

このメソッドに引数はありません。
toLowerCase は、文字列のアルファベットを小文字にした文字列を返します。
全角文字は変換されません。
これらのメソッドは、もとの文字列には影響を与えません。
`例:
var lwr="ABCDEF".toLowerCase(); // lwr には "abcdef" が代入される
`
Note
現バージョンの TJS2 では 文字コード 0x80 未満の文字に対してのみ変換を行います。

# toUpperCase

このメソッドは toLowerCase と逆で、小文字のアルファベットを大文字にした文字列を返します。

# substring

substring メソッドは、文字列の部分文字列を返します。
`構文 : substring(<開始文字位置>[,<文字数>])`
文字列の、<開始文字位置>から<文字数分>の部分文字列を返します。元の文字列に影響は与えません。<文字数> を省略すると、<開始文字位置> 以降の文字列がすべて返されます。
JavaScript の同メソッドとは引数の意味が違うので注意してください。
`例:
var ss="abcdefghijkl".substring(3,3); // ss には "def" が代入される`

# substr

substring と同じです。

# sprintf

sprintf メソッドは、文字列を書式化します。
`構文 : sprintf(引数, 引数, ....)
`
文字列を書式文字列と見なし、C言語における sprintf 同様のテキストのフォーマッティングを行った文字列を返します。元の文字列には影響を与えません。
`例:
var formatted = "%04X %c %5d".sprintf(v1, v2, dic[v1]);`

# replace

replace メソッドは、文字列の置き換えを行います。
`構文 : replace(<パターン>, <置き換え後文字列>)`
正規表現パターンに従って文字列の置き換えを行い、置き換えを行ったあとの文字列を返します。元の文字列には影響を与えません。
動作については RegExp クラス の replace メソッドを参照してください。

# split

split メソッドは、文字列を分割します。
`構文 : split(<パターン/デリミタ集合>, <(予約)>, <空の要素を無視するか=false>)`
文字列を分割した結果が格納された配列オブジェクトを返します。
Array クラス の split メソッドも参照してください (引数の順番に注意してください)。

# escape

escape メソッドは、文字列を、TJSの文字列即値内で表現可能な形式に変換します。\ や " などの記号はすべて \ 記号を用いて特殊な用途として解釈されなくされます (エスケープされます)。
`構文 : escape()`
エスケープされた文字列を返します。元の文字列には影響を与えません。
`例:
var escaped = str.escape(); // str 中の " は \" に、\ は \\ に変換されるなど
`

# trim

trim メソッドは、文字列の先頭と最後の空白を取り除いた文字列を返します。元の文字列には影響を与えません。
先頭と最後の空白とは、文字コードがU+0001〜U+0020の文字を指します。つまり、ASCII制御文字なども含まれますが、いわゆる全角の空白は含みません。
連続して先頭または最後にこれらの空白があった場合は、すべて取り除かれます。
`構文 : trim()`
先頭と末尾の空白文字が削除された文字列を返します。元の文字列には影響を与えません。
`例:
var str = " Hoge ".trim(); // str は "Hoge" です。
`

# reverse

reverse メソッドは、文字の並びを逆転した文字列を返します。元の文字列には影響を与えません。
現バージョンのTJS2では、UTF-16のうちサロゲートペアを含む文字列の動作は保証しません。
`構文 : reverse()`
文字の並びを逆転した文字列を返します。元の文字列には影響を与えません。
`例:
var str = "Hoge".reverse(); // str は "egoH" です。`

# repeat

repeat メソッドは、指定した回数だけ文字列を繰り返した文字列を返します。元の文字列には影響を与えません。
`構文 : repeat(count)`
count個、この文字列を繰り返した文字列を返します。元の文字列には影響を与えません。
`例:
var str = "Hoge".repeat(3); // str は "HogeHogeHoge" です。`