String

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

構文

文字列リテラルは次のような形をとります。

'string text'
"string text"
"中文 español Deutsch English देवनागरी العربية português বাংলা русский 日本語 norsk bokmål ਪੰਜਾਬੀ 한국어 தமிழ் עברית"

文字列は String グローバルオブジェクトを直接利用して構築することもできます。

String(thing)

引数

thing

文字列に変換する対象

テンプレートリテラル

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

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

エスケープ表記

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

長い文字列リテラル

時々、コードに非常に長い文字列が含まれる場合があります。行を延々と長くしたり、エディターの気まぐれによって折り返されたりするよりも、実際の文字列の内容に影響を与えずに文字列をソースコード内で複数行に分割したいことがあります。これを行うには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 プロパティ、 文字列に対する + および += 演算子を用いた文字列の連結、文字列の中の部分文字列の存在や位置をチェックする indexOf() メソッド、部分文字列を取り出す substring() メソッドが挙げられます。

文字へのアクセス

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

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

そしてもうひとつは、文字列を配列のようなオブジェクトとして扱い、数値の添字を用いる方法です。 (ECMAScript 5 で導入)

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

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

文字列の比較

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

var a = 'a';
var b = 'b';
if (a < b) { // true
  console.log(a + ' is less than ' + b);
} else if (a > b) {
  console.log(a + ' is greater than ' + b);
} else {
  console.log(a + ' and ' + b + ' are equal.');
}

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

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

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

文字列リテラル (二重引用符または単一引用符で示されます)、および 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 オブジェクトは他のオブジェクトと同様に、オブジェクトとしてそのままの文字列を返します。

var s1 = '2 + 2';             // 文字列プリミティブ値を生成
var s2 = new String('2 + 2'); // String オブジェクトを生成
console.log(eval(s1));        // 数値の 4 を返す
console.log(eval(s2));        // 文字列の "2 + 2" を返す

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

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

console.log(eval(s2.valueOf())); // 数値の 4 を返す

プロパティ

String.prototype

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

メソッド

String.fromCharCode()

指定された Unicode 値の列から生成した文字列を返します。

String.fromCodePoint()

指定された Unicode コードポイントの列から生成した文字列を返します。

String.raw()

生のテンプレート文字列から生成した文字列を返します。

String インスタンス

プロパティ

メソッド

HTML に関連しないメソッド

HTML ラッパーメソッド

例

文字列変換

String を使用すると、 toString() よりも信頼性の高い代替手段となり、 null, undefined, symbols に対して使用することもできます。

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

仕様書

ブラウザーの互換性

関連情報

• DOMString
• StringView — 型付き配列に基づいた C 風の文字列の表現
• Binary strings