substr Method (String) (JavaScript)

Gets a substring beginning at the specified location and having the specified length.


stringvar.substr(start [, length ])   


Required. A string literal or String object from which the substring is extracted.

Required. The starting position of the desired substring. The index of the first character in the string is zero.

Optional. The number of characters to include in the returned substring.


If length is zero or negative, an empty string is returned. If not specified, the substring continues to the end of stringvar.


The following example illustrates the use of the substr method.

var s = "The quick brown fox jumps over the lazy dog.";  
var ss = s.substr(10, 5);    
document.write("[" + ss + "] <br>");  

ss = s.substr(10);  
document.write("[" + ss + "] <br>");  

ss = s.substr(10, -5);  
document.write("[" + ss + "] <br>");  

// Output:  
// [brown]   
// [brown fox jumps over the lazy dog.]   
// []  


Supported in the following document modes: Quirks, Internet Explorer 6 standards, Internet Explorer 7 standards, Internet Explorer 8 standards, Internet Explorer 9 standards, Internet Explorer 10 standards, Internet Explorer 11 standards. Also supported in Store apps (Windows 8 and Windows Phone 8.1). See Version Information.

Applies To: String Object

See Also

substring Method (String)