michael@0: /* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
michael@0: /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0:  * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0:  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0: 
michael@0: 
michael@0: /**
michael@0:    File Name:          15.5.4.8-3.js
michael@0:    ECMA Section:       15.5.4.8 String.prototype.split( separator )
michael@0:    Description:
michael@0: 
michael@0:    Returns an Array object into which substrings of the result of converting
michael@0:    this object to a string have been stored. The substrings are determined by
michael@0:    searching from left to right for occurrences of the given separator; these
michael@0:    occurrences are not part of any substring in the returned array, but serve
michael@0:    to divide up this string value. The separator may be a string of any length.
michael@0: 
michael@0:    As a special case, if the separator is the empty string, the string is split
michael@0:    up into individual characters; the length of the result array equals the
michael@0:    length of the string, and each substring contains one character.
michael@0: 
michael@0:    If the separator is not supplied, then the result array contains just one
michael@0:    string, which is the string.
michael@0: 
michael@0:    When the split method is called with one argument separator, the following steps are taken:
michael@0: 
michael@0:    1.   Call ToString, giving it the this value as its argument.
michael@0:    2.   Create a new Array object of length 0 and call it A.
michael@0:    3.   If separator is not supplied, call the [[Put]] method of A with 0 and
michael@0:    Result(1) as arguments, and then return A.
michael@0:    4.   Call ToString(separator).
michael@0:    5.   Compute the number of characters in Result(1).
michael@0:    6.   Compute the number of characters in the string that is Result(4).
michael@0:    7.   Let p be 0.
michael@0:    8.   If Result(6) is zero (the separator string is empty), go to step 17.
michael@0:    9.   Compute the smallest possible integer k not smaller than p such that
michael@0:    k+Result(6) is not greater than Result(5), and for all nonnegative
michael@0:    integers j less than Result(6), the character at position k+j of
michael@0:    Result(1) is the same as the character at position j of Result(2);
michael@0:    but if there is no such integer k, then go to step 14.
michael@0:    10.   Compute a string value equal to the substring of Result(1), consisting
michael@0:    of the characters at positions p through k1, inclusive.
michael@0:    11.   Call the [[Put]] method of A with A.length and Result(10) as arguments.
michael@0:    12.   Let p be k+Result(6).
michael@0:    13.   Go to step 9.
michael@0:    14.   Compute a string value equal to the substring of Result(1), consisting
michael@0:    of the characters from position p to the end of Result(1).
michael@0:    15.   Call the [[Put]] method of A with A.length and Result(14) as arguments.
michael@0:    16.   Return A.
michael@0:    17.   If p equals Result(5), return A.
michael@0:    18.   Compute a string value equal to the substring of Result(1), consisting of
michael@0:    the single character at position p.
michael@0:    19.   Call the [[Put]] method of A with A.length and Result(18) as arguments.
michael@0:    20.   Increase p by 1.
michael@0:    21.   Go to step 17.
michael@0: 
michael@0:    Note that the split function is intentionally generic; it does not require that its this value be a String
michael@0:    object. Therefore it can be transferred to other kinds of objects for use as a method.
michael@0: 
michael@0:    Author:             christine@netscape.com
michael@0:    Date:               12 november 1997
michael@0: */
michael@0: 
michael@0: var SECTION = "15.5.4.8-3";
michael@0: var VERSION = "ECMA_1";
michael@0: startTest();
michael@0: var TITLE   = "String.prototype.split";
michael@0: 
michael@0: writeHeaderToLog( SECTION + " "+ TITLE);
michael@0: 
michael@0: var TEST_STRING = "";
michael@0: var EXPECT = new Array();
michael@0: 
michael@0: // this.toString is the empty string.
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String(); s.split().length",
michael@0: 		1,
michael@0: 		eval("var s = new String(); s.split().length") );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String(); s.split()[0]",
michael@0: 		"",
michael@0: 		eval("var s = new String(); s.split()[0]") );
michael@0: 
michael@0: // this.toString() is the empty string, separator is specified.
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String(); s.split('').length",
michael@0: 		0,
michael@0: 		eval("var s = new String(); s.split('').length") );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String(); s.split(' ').length",
michael@0: 		1,
michael@0: 		eval("var s = new String(); s.split(' ').length") );
michael@0: 
michael@0: // this to string is " "
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String(' '); s.split().length",
michael@0: 		1,
michael@0: 		eval("var s = new String(' '); s.split().length") );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String(' '); s.split()[0]",
michael@0: 		" ",
michael@0: 		eval("var s = new String(' '); s.split()[0]") );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String(' '); s.split('').length",
michael@0: 		1,
michael@0: 		eval("var s = new String(' '); s.split('').length") );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String(' '); s.split('')[0]",
michael@0: 		" ",
michael@0: 		eval("var s = new String(' '); s.split('')[0]") );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String(' '); s.split(' ').length",
michael@0: 		2,
michael@0: 		eval("var s = new String(' '); s.split(' ').length") );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String(' '); s.split(' ')[0]",
michael@0: 		"",
michael@0: 		eval("var s = new String(' '); s.split(' ')[0]") );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"\"\".split(\"\").length",
michael@0: 		0,
michael@0: 		("".split("")).length );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"\"\".split(\"x\").length",
michael@0: 		1,
michael@0: 		("".split("x")).length );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"\"\".split(\"x\")[0]",
michael@0: 		"",
michael@0: 		("".split("x"))[0] );
michael@0: 
michael@0: test();
michael@0: 
michael@0: function Split( string, separator ) {
michael@0:   string = String( string );
michael@0: 
michael@0:   var A = new Array();
michael@0: 
michael@0:   if ( arguments.length < 2 ) {
michael@0:     A[0] = string;
michael@0:     return A;
michael@0:   }
michael@0: 
michael@0:   separator = String( separator );
michael@0: 
michael@0:   var str_len = String( string ).length;
michael@0:   var sep_len = String( separator ).length;
michael@0: 
michael@0:   var p = 0;
michael@0:   var k = 0;
michael@0: 
michael@0:   if ( sep_len == 0 ) {
michael@0:     for ( ; p < str_len; p++ ) {
michael@0:       A[A.length] = String( string.charAt(p) );
michael@0:     }
michael@0:   }
michael@0:   return A;
michael@0: }