Section 24.173. String.slice( ): extract a substring


24.173. String.slice( ): extract a substring

ECMAScript v3

24.173.1. Synopsis

string.slice(start, end)

24.173.1.1. Arguments

start

The string index where the slice is to begin. If negative, this argument specifies a position measured from the end of the string. That is, -1 indicates the last character, -2 indicates the second from last character, and so on.


end

The string index immediately after the end of the slice. If not specified, the slice includes all characters from start to the end of the string. If this argument is negative, it specifies a position measured from the end of the string.

24.173.1.2. Returns

A new string that contains all the characters of string from and including start, and up to but not including end.

24.173.2. Description

slice( ) returns a string containing a slice, or substring, of string. It does not modify string.

The String methods slice( ), substring( ), and the deprecated substr( ) all return specified portions of a string. slice( ) is more flexible than substring( ) because it allows negative argument values. slice( ) differs from substr( ) in that it specifies a substring with two character positions, while substr( ) uses one position and a length. Note also that String.slice( ) is an analog of Array.slice( ).

24.173.3. Example

 var s = "abcdefg"; s.slice(0,4)    // Returns "abcd" s.slice(2,4)    // Returns "cd" s.slice(4)      // Returns "efg" s.slice(3,-1)   // Returns "def" s.slice(3,-2)   // Returns "de" s.slice(-3,-1)  // Should return "ef"; returns "abcdef" in IE 4 

24.173.4. Bugs

Negative values for start do not work in Internet Explorer 4 (but they do in later versions of IE). Instead of specifying a character position measured from the end of the string, they specify character position 0.

24.173.5. See Also

 Array.slice( ), String.substring( ) 




JavaScript. The Definitive Guide
JavaScript: The Definitive Guide
ISBN: 0596101996
EAN: 2147483647
Year: 2004
Pages: 767

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net