Core JavaScript 1.5 Reference:Global Objects:String:substring

出典: MDC

目次 1 概要 2 構文 3 パラメータ 4 詳細 5 例 5.1 例: substring メソッドの使用 5.2 例: 文字列内の部分文字列を置き換える 6 参照

[編集] 概要

String オブジェクトの部分集合を返します。

String のメソッド
実装されたバージョン:	JavaScript 1.0, NES2.0
ECMA バージョン:	ECMA-262

[編集] 構文

substring(indexA, [indexB])

[編集] パラメータ

indexA 

0 と 文字列の長さから 1 引いた数の間にある整数。

indexB 

（任意）0 と文字列の長さの間にある整数。

[編集] 詳細

substring は indexA から indexB 未満の文字を取り出します。特に、:

• indexA が indexB と等しい場合、 substring は空の文字列を返します。
• indexB が省略された場合、substring は文字列の最後までの文字を取り出します。
• 両方の引数が 0 未満、あるいは、 数字ではないデータ型 (NaN) だった場合、 それは 0 だったものとして扱われます。
• 両方の引数が stringName.length より大きかった場合、それは stringName.length だったものとして扱われます。

indexA が indexB より大きかった場合、substring は 2 つの引数が交換されたものとして実行されます。 例えば、 str.substring(1, 0) == str.substring(0, 1) です。

[編集] 例

[編集] 例: substring メソッドの使用

以下の例は、"Mozilla" という文字列から取り出した文字を表示するために substring メソッドを使用しています。:

// print（出力） 関数が定義されていると仮定してください。
var anyString = "Mozilla";
　 
// "Moz" を表示します
print(anyString.substring(0,3));
print(anyString.substring(3,0));

// "lla" を表示します。
print(anyString.substring(4,7));
print(anyString.substring(7,4));

// "Mozill" を表示します
print(anyString.substring(0,6));

// "Mozilla" を表示します
print(anyString.substring(0,7));
print(anyString.substring(0,10));

[編集] 例: 文字列内の部分文字列を置き換える

以下の例は、文字列内の部分文字列を置き換えます。それは個々の文字と部分文字列の両方を置き換えるでしょう。例の最後で呼ばれる関数は、"Brave New World" を "Brave New Web" に変更します。

function replaceString(oldS, newS, fullS) {
// fullS という文字列内で oldS を newS に置き換えます。
   for (var i = 0; i < fullS.length; i++) {
      if (fullS.substring(i, i + oldS.length) == oldS) {
         fullS = fullS.substring(0, i) + newS + fullS.substring(i + oldS.length, fullS.length);
      }
   }
   return fullS;
}

replaceString("World", "Web", "Brave New World");

[編集] 参照

substr