String

概要

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

構文

String リテラルは次の様な構文となります。

'string text'

"string text"

String グローバルオブジェクトを直接的に使用する方法は、次の様な構文となります。

String(thing)

new String(thing)

引数

thing

文字列に変換する対象

説明

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

文字へのアクセス

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

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

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

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

For character access using bracket notation, attempting to delete or assign a value to these properties will not succeed. The properties involved are neither writable nor configurable. (See Object.defineProperty for more information.)

文字列の比較

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 メソッドを使用して同等の結果を得る事もできます。

プリミティブ値としての文字列と String オブジェクトの区別

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 primitives and String objects also give different results when using eval. Primitives passed to eval are treated as source code; String objects are treated as all other objects are, by returning the object. For example:

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"

For these reasons, code may break when it encounters String objects when it expects a primitive string instead, although generally authors need not worry about the distinction.

A String object can always be converted to its primitive counterpart with the valueOf method.

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

プロパティ

prototype

Allows the addition of properties to a String object.

メソッド

fromCharCode

Returns a string created by using the specified sequence of Unicode values.

String generic methods

The String instance methods are also available in Firefox as of JavaScript 1.6 (though not part of the ECMAScript standard) on the String object for applying String methods to any object:

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

Generics are also available on Array methods.

The following is a shim to provide support to non-supporting browsers:

/*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 インスタンス

プロパティ

メソッド

例

It's possible to use String as a "safer" toString alternative, as although it still normally calls the underlying toString, it also works for null and undefined. For example:

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

ブラウザ実装状況