String

概要

String グローバルオブジェクトは文字列のコンストラクタ、または文字列シーケンスです。

構文

String リテラルは次の様な形をとります。

'string text'
"string text"

String グローバルオブジェクトを直接的に利用する際には、次の形をとります。

String(thing)
new String(thing)

引数

thing

文字列に変換する対象

テンプレートリテラル

ECMAScript 6から、String リテラルには テンプレートリテラル が追加されました。

`hello world`
`hello!
 world!`
`hello ${who}`
escape `<a>${who}</a>`

エスケープシーケンス

通常の文字列とは異なる特殊な文字を表示するためには、エスケープシーケンスを利用します。

NOTE: 他の言語とは異なり、JavaScript はシングルクォートに囲まれた文字列とダブルクォートに囲まれた文字列に違いはありません。したがって、エスケープシーケンスはシングルクォート内でもダブルクォート内でも差異なく実行されます。

長い文字列リテラル

時々、コードに非常に長い文字列が含まれる場合があります。その時、延々と続く行が含まれたり、エディタの気まぐれによってラップされるよりも、実際の文字列コンテンツに影響を与えずに文字列をソースコード内で複数行に分割したいことがあります。これを行うには2つの方法があります。

複数の文字列を一緒にするために、+演算子をこのように使えます。

let longString = "This is a very long string which needs " +
                 "to wrap across multiple lines because " +
                 "otherwise my code is unreadable.";

または、文字列が次の行に続くことを示すために、各行の最後でバックスラッシュ文字("\") を使用できます。バックスラッシュの後には、（改行を除いて）スペースや何らかの文字、インデントなどがないか確認してください。さもないと、これは動作しません。このフォームは以下のようになります。

let longString = "This is a very long string which needs \
to wrap across multiple lines because \
otherwise my code is unreadable.";

これらの結果はともに同じ文字列が生成されます。

説明

文字列はテキスト形式で表現可能なデータを保持するのに便利です。最もよく使われる操作として、文字数をチェックする length プロパティ、 + 演算子や += 演算子を用いた文字列の連結、文字列の中の部分文字列の位置をチェックする substring / substr メソッドが挙げられます。

文字へのアクセス

文字列内の個々の文字へのアクセス方法には、二通りの方法があります。そのひとつは charAt メソッドです。

return 'ねこ'.charAt(1); // "こ" が返される

そしてもうひとつは、配列のようなオブジェクトとして文字列を扱い、数値のインデックスを用いる方法です。

return 'ねこ'[1]; // "こ" が返される。

ブラケット記法を使用した文字列アクセスでは、これらのプロパティに値を設定したり削除したりすることはできません。関連したプロパティは書き込みも設定もできません。(より詳細はObject.definePropertyを見てください。)

文字列の比較

C 言語では 文字列の比較の為に strcmp() 関数を用います。 JavaScript では単純に 小なり / 大なり演算子を用います。

var a = "a";
var b = "b";

if (a < b) // true
  print(a + " is less than " + b);
else if (a > b)
  print(a + " is greater than " + b);
else
  print(a + " and " + b + " are equal.");

String インスタンスから継承される localeCompare メソッドを使用して同等の結果を得る事もできます。

プリミティブ値とオブジェクトの区別

JavaScript では、プリミティブ値の文字列とString オブジェクトの文字列が区別されます。 (真偽値 と 数値 も同様にプリミティブ値とオブジェクトで区別されます。)

文字列リテラル (ダブルクォーテーションかシングルクォーテーションで示されます)、および String 関数を通常通り呼び出した場合 (すなわち new 演算子 を使わずに呼び出した場合) に返される値は、プリミティブ値の文字列です。

JavaScript では、必要に応じてプリミティブ値の文字列が自動的に String オブジェクトに変換されます。そのため、プリミティブ値の文字列に対してメソッド呼び出しを行うことで、String オブジェクトのメソッドを使用することができます。

プリミティブ値の文字列に対して、メソッドが呼び出されようとしている場合、またはプロパティの参照が行われようとしている場合、JavaScript は自動的にプリミティブ値の文字列をオブジェクトでラップします。その上で、該当するオブジェクトに対してメソッド呼び出しやプロパティの参照を行っています。

var s_prim = "foo";
var s_obj = new String(s_prim);

console.log(typeof s_prim); // Logs "string"
console.log(typeof s_obj);  // Logs "object"

プリミティブ値の文字列と String オブジェクトは eval を利用しても異なる結果となります。 eval を実行した場合、プリミティブ値の文字列はソースコードとして扱われます。一方で、String オブジェクトは他のオブジェクトと同様にオブジェクトとしてそのままの文字列を返します。

s1 = "2 + 2";               // creates a string primitive
s2 = new String("2 + 2");   // creates a String object
console.log(eval(s1));      // returns the number 4
console.log(eval(s2));      // returns the string "2 + 2"

こういった理由から、プリミティブ値の文字列を期待して実装されたコードは String オブジェクトでうまく動作しないことがあります。しかし、一般的にはこれらの違いを考慮しなければならないことはあまりありません。

なお、String オブジェクトは valueOf メソッドを利用することでプリミティブ値の文字列に変換することができます。

console.log(eval(s2.valueOf())); // returns the number 4

プロパティ

prototype

Stringオブジェクトにプロパティの追加を許可します。

メソッド

fromCharCode

Unicode値の指定されたシーケンスを使用して生成した文字列を返します。

Stringジェネリック

（ECMAScript標準に含まれていませんが）FirefoxのJavaScript1.6では、Stringインスタンスメソッドを、任意のオブジェクトにStringメソッドを適用するためにStringオブジェクトで使用できます。

var num = 15;
alert(String.replace(num, /5/, '2'));

ジェネリックは、Arrayメソッドでも使用できます。

以下は、非サポートブラウザへサポートを提供するシムです。

/*globals define*/
// Assumes all supplied String instance methods already present (one may use shims for these if not available)
(function () {
    'use strict';

    var i,
        // We could also build the array of methods with the following, but the
        //   getOwnPropertyNames() method is non-shimable:
        // Object.getOwnPropertyNames(String).filter(function (methodName) {return typeof String[methodName] === 'function'});
        methods = [
            'quote', 'substring', 'toLowerCase', 'toUpperCase', 'charAt',
            'charCodeAt', 'indexOf', 'lastIndexOf', 'startsWith', 'endsWith',
            'trim', 'trimLeft', 'trimRight', 'toLocaleLowerCase',
            'toLocaleUpperCase', 'localeCompare', 'match', 'search',
            'replace', 'split', 'substr', 'concat', 'slice', 'fromCharCode'
        ],
        methodCount = methods.length,
        assignStringGeneric = function (methodName) {
            var method = String.prototype[methodName];
            String[methodName] = function (arg1) {
                return method.apply(arg1, Array.prototype.slice.call(arguments, 1));
            };
        };

    for (i = 0; i < methodCount; i++) {
        assignStringGeneric(methods[i]);
    }
}());

String インスタンス

プロパティ

メソッド

HTML に関連しないメソッド

HTML ラッパーメソッド

例

基底となるtoStringをいまだに呼び出していますが、この例ではtoStringの代替えとしてより安全に文字列を扱うことができます。そのため、nullとundefinedでも動作します。例えば：

var outputStrings = [];
for (let i = 0, n = inputValues.length; i < n; ++i) {
  outputStrings.push(String(inputValues[i]));
}

ブラウザ実装状況