Add optional startIndex to String.replaceFirst

tests/corelib/string_replace_test.dart

 // Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 import "package:expect/expect.dart";
 
 class StringReplaceTest {
   static testMain() {
     Expect.equals(
         "AtoBtoCDtoE", "AfromBtoCDtoE".replaceFirst("from", "to"));
@@ skipping 24 matching lines @@
 
     // Test replacing by the empty string.
     Expect.equals("", "from".replaceFirst("from", ""));
     Expect.equals("AB", "AfromB".replaceFirst("from", ""));
 
     // Test changing the empty string.
     Expect.equals("to", "".replaceFirst("", "to"));
 
     // Test replacing the empty string.
     Expect.equals("toAtoBtoCto", "AtoBtoCto".replaceFirst("", "to"));
+
+    // Test startIndex.
+    Expect.equals(
+        "foo-AAA-foo-bar", "foo-bar-foo-bar".replaceFirst("bar", "AAA", 4));
+
+    // Test startIndex skipping one case at the begining.
+    Expect.equals(
+        "foo-bar-AAA-bar", "foo-bar-foo-bar".replaceFirst("foo", "AAA", 1));
+
+    // Test startIndex skipping one case at the begining.
+    Expect.equals(
+        "foo-bar-foo-AAA", "foo-bar-foo-bar".replaceFirst("bar", "AAA", 5));
+
+    // Test startIndex replacing with the empty string.
+    Expect.equals(
+        "foo-bar--bar", "foo-bar-foo-bar".replaceFirst("foo", "", 1));
+
+    // Test negative startIndex

[Bill Hesse, 2014/08/11 07:47:47]

Add tests for null and object as startIndex.

[srawlins, 2014/08/14 00:42:45]

Done.

+    Expect.throws(
+        () => "hello".replaceFirst("h", "X", -1), (e) => e is RangeError);
+
+    // Test startIndex too large
+    Expect.throws(
+        () => "hello".replaceFirst("h", "X", 6), (e) => e is RangeError);
   }
 }

[Lasse Reichstein Nielsen, 2014/08/13 08:35:09]

Test with regexps too, and with strings that contains something that looks like
a regexp, e.g.,
   Expect.equals("aaax", "aaaa{3}".replaceFirst("a{3}", "x", 1));
   Expect.equals("ax{3}", "aaaa{3}".replaceFirst(
      new RegExp("a{3}"), "x", 1));

[srawlins, 2014/08/14 00:42:45]

Done.

 
 main() {
   StringReplaceTest.testMain();
 }