Apply your JS skills to key Mozilla projects as an MDN Fellow! http://mzl.la/MDNFellowship

mozilla
Your Search Results

    String.prototype.substr()

    概要

    文字列内における文字を、指定した位置から指定した数だけ返します。

    String のメソッド
    実装されたバージョン JavaScript 1.0 / JScript 3
    ECMAScript エディション 無し。しかし、ECMA-262 第3版 には、substr と類似のセマンティクスを取り上げている非標準のセクションがあります。

    構文

    var sub = string.substr(start[,length]);

    引数

    start
    文字を取り出す位置( 0 から文字列の長さ以下までの整数)
    length
    取り出す文字の数

    詳細

    start は文字のインデックスです。一番最初の文字のインデックスは、 0 で、最後の文字のインデックスは、文字列の長さから 1 を引いた数です。substr は、start から文字の取り出しを開始し、length 個の文字を集めます(start から文字列の最後までの長さが指定した length より短かった場合は、length より少ない数の文字を返すでしょう)。

    start が正の数かつ文字列の長さ以上である場合、substr は空の文字列を返します。

    start が負の数である場合、substr はそれを文字列の最後から数えた文字のインデックスとして使用します。start が負の数かつ start の絶対値が文字列の長さより大きい場合、substr は開始インデックスとして 0 を使用します。注: start の引数に負の数の値を指定することは、Microsoft JScript ではサポートされません
    【訳注: JScript では start に負の数を指定した場合、正の数として扱われます】

    length が 0 あるいは負の数の場合、substr は空の文字列を返します。length が省略された場合、start から文字列の最後までの文字を取り出します。

    例: substr メソッドの使用

    // ※出力用の println 関数は既に定義されているものとする
    
    var str = "abcdefghij";
    
    println( "(1,2): "    + str.substr(1, 2) );
    println( "(-3,2): "   + str.substr(-3, 2) );
    println( "(-3): "     + str.substr(-3) );
    println( "(1): "      + str.substr(1) );
    println( "(-20, 2): " + str.substr(-20, 2) );
    println( "(20, 2): "  + str.substr(20, 2) );
    

    出力結果は以下の様なものになります。

    (1,2): bc
    (-3,2): hi
    (-3): hij
    (1): bcdefghij
    (-20, 2): ab
    (20, 2):
    

    関連情報

    ドキュメントのタグと貢献者

    Contributors to this page: Julien.stuby, Potappo, teoli, ethertank, Mgjbot
    最終更新者: teoli,