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-2.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-2";
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: // case where separator is the empty string.
michael@0: 
michael@0: var TEST_STRING = "this is a string object";
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String( "+ TEST_STRING +" ); s.split('').length",
michael@0: 		TEST_STRING.length,
michael@0: 		eval("var s = new String( TEST_STRING ); s.split('').length") );
michael@0: 
michael@0: for ( var i = 0; i < TEST_STRING.length; i++ ) {
michael@0: 
michael@0:   new TestCase(   SECTION,
michael@0: 		  "var s = new String( "+TEST_STRING+" ); s.split('')["+i+"]",
michael@0: 		  TEST_STRING.charAt(i),
michael@0: 		  eval("var s = new String( TEST_STRING ); s.split('')["+i+"]") );
michael@0: }
michael@0: 
michael@0: // case where the value of the separator is undefined.  in this case,
michael@0: // the this value is returned.
michael@0: 
michael@0: var TEST_STRING = "thisundefinedisundefinedaundefinedstringundefinedobject";
michael@0: var EXPECT_STRING = new Array( TEST_STRING );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String( "+ TEST_STRING +" ); s.split(void 0).length",
michael@0: 		EXPECT_STRING.length,
michael@0: 		eval("var s = new String( TEST_STRING ); s.split(void 0).length") );
michael@0: 
michael@0: for ( var i = 0; i < EXPECT_STRING.length; i++ ) {
michael@0:   new TestCase(   SECTION,
michael@0: 		  "var s = new String( "+TEST_STRING+" ); s.split(void 0)["+i+"]",
michael@0: 		  EXPECT_STRING[i],
michael@0: 		  eval("var s = new String( TEST_STRING ); s.split(void 0)["+i+"]") );
michael@0: }
michael@0: 
michael@0: // case where the value of the separator is null.  in this case the value of the separator is "null".
michael@0: TEST_STRING = "thisnullisnullanullstringnullobject";
michael@0: var EXPECT_STRING = new Array( "this", "is", "a", "string", "object" );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String( "+ TEST_STRING +" ); s.split(null).length",
michael@0: 		EXPECT_STRING.length,
michael@0: 		eval("var s = new String( TEST_STRING ); s.split(null).length") );
michael@0: 
michael@0: for ( var i = 0; i < EXPECT_STRING.length; i++ ) {
michael@0:   new TestCase(   SECTION,
michael@0: 		  "var s = new String( "+TEST_STRING+" ); s.split(null)["+i+"]",
michael@0: 		  EXPECT_STRING[i],
michael@0: 		  eval("var s = new String( TEST_STRING ); s.split(null)["+i+"]") );
michael@0: }
michael@0: 
michael@0: // case where the value of the separator is a boolean.
michael@0: TEST_STRING = "thistrueistrueatruestringtrueobject";
michael@0: var EXPECT_STRING = new Array( "this", "is", "a", "string", "object" );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String( "+ TEST_STRING +" ); s.split(true).length",
michael@0: 		EXPECT_STRING.length,
michael@0: 		eval("var s = new String( TEST_STRING ); s.split(true).length") );
michael@0: 
michael@0: for ( var i = 0; i < EXPECT_STRING.length; i++ ) {
michael@0:   new TestCase(   SECTION,
michael@0: 		  "var s = new String( "+TEST_STRING+" ); s.split(true)["+i+"]",
michael@0: 		  EXPECT_STRING[i],
michael@0: 		  eval("var s = new String( TEST_STRING ); s.split(true)["+i+"]") );
michael@0: }
michael@0: 
michael@0: // case where the value of the separator is a number
michael@0: TEST_STRING = "this123is123a123string123object";
michael@0: var EXPECT_STRING = new Array( "this", "is", "a", "string", "object" );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String( "+ TEST_STRING +" ); s.split(123).length",
michael@0: 		EXPECT_STRING.length,
michael@0: 		eval("var s = new String( TEST_STRING ); s.split(123).length") );
michael@0: 
michael@0: for ( var i = 0; i < EXPECT_STRING.length; i++ ) {
michael@0:   new TestCase(   SECTION,
michael@0: 		  "var s = new String( "+TEST_STRING+" ); s.split(123)["+i+"]",
michael@0: 		  EXPECT_STRING[i],
michael@0: 		  eval("var s = new String( TEST_STRING ); s.split(123)["+i+"]") );
michael@0: }
michael@0: 
michael@0: 
michael@0: // case where the value of the separator is a number
michael@0: TEST_STRING = "this123is123a123string123object";
michael@0: var EXPECT_STRING = new Array( "this", "is", "a", "string", "object" );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String( "+ TEST_STRING +" ); s.split(123).length",
michael@0: 		EXPECT_STRING.length,
michael@0: 		eval("var s = new String( TEST_STRING ); s.split(123).length") );
michael@0: 
michael@0: for ( var i = 0; i < EXPECT_STRING.length; i++ ) {
michael@0:   new TestCase(   SECTION,
michael@0: 		  "var s = new String( "+TEST_STRING+" ); s.split(123)["+i+"]",
michael@0: 		  EXPECT_STRING[i],
michael@0: 		  eval("var s = new String( TEST_STRING ); s.split(123)["+i+"]") );
michael@0: }
michael@0: 
michael@0: // case where the separator is not in the string
michael@0: TEST_STRING = "this is a string";
michael@0: EXPECT_STRING = new Array( "this is a string" );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String( " + TEST_STRING + " ); s.split(':').length",
michael@0: 		1,
michael@0: 		eval("var s = new String( TEST_STRING ); s.split(':').length") );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String( " + TEST_STRING + " ); s.split(':')[0]",
michael@0: 		TEST_STRING,
michael@0: 		eval("var s = new String( TEST_STRING ); s.split(':')[0]") );
michael@0: 
michael@0: // case where part but not all of separator is in the string.
michael@0: TEST_STRING = "this is a string";
michael@0: EXPECT_STRING = new Array( "this is a string" );
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String( " + TEST_STRING + " ); s.split('strings').length",
michael@0: 		1,
michael@0: 		eval("var s = new String( TEST_STRING ); s.split('strings').length") );
michael@0: 
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String( " + TEST_STRING + " ); s.split('strings')[0]",
michael@0: 		TEST_STRING,
michael@0: 		eval("var s = new String( TEST_STRING ); s.split('strings')[0]") );
michael@0: 
michael@0: // case where the separator is at the end of the string
michael@0: TEST_STRING = "this is a string";
michael@0: EXPECT_STRING = new Array( "this is a " );
michael@0: new TestCase(   SECTION,
michael@0: 		"var s = new String( " + TEST_STRING + " ); s.split('string').length",
michael@0: 		2,
michael@0: 		eval("var s = new String( TEST_STRING ); s.split('string').length") );
michael@0: 
michael@0: for ( var i = 0; i < EXPECT_STRING.length; i++ ) {
michael@0:   new TestCase(   SECTION,
michael@0: 		  "var s = new String( "+TEST_STRING+" ); s.split('string')["+i+"]",
michael@0: 		  EXPECT_STRING[i],
michael@0: 		  eval("var s = new String( TEST_STRING ); s.split('string')["+i+"]") );
michael@0: }
michael@0: 
michael@0: test();