String Additions

README.md

@@ -188,6 +188,28 @@ supporting a number of use-cases, including:
 `loop('la ', 0, 8) => 'la la la'  // no tailing space`
   * Tailing: `loop('/path/to/some/file.txt', -3) => 'txt'`
   * Reversing: `loop('top', 3, 0) => 'pot'`
+
+`capitalize` allows you to capitalize every first letter of every word in a given
+string. For example:
+
+`capitalize('this was a triumph!') => 'This Was A Triumph!'`
+
+`replace` allows you to replace a porton of a string starting from a specified index.
+Optionally, you can specifiy the length to overwrite the original string from the specified
+index with the input string. Examples:
+
+`replace("I'm doing a note here", 5, 'making', overwrite: 5)` => "I'm making a note here"`
+
+`replace('Huge suckess!', 8, 'c') => 'Huge success!'`
+
+`insert` inserts a string into another string at the given index. Example:
+
+`insert('this a triumph!', 4, 'was ') => 'this was a triumph!'`
+
+`remove` allows you to remove a specified length of text from a string at
+ a specified index. Example:
+
+`remove('Whaaaaaat?', 2, 5) => 'What?'`
 
 [quiver.strings]: http://google.github.io/quiver-dart/#quiver/quiver-strings
 

lib/strings.dart

@@ -241,3 +241,58 @@ bool equalsIgnoreCase(String a, String b) =>
  */
 int compareIgnoreCase(String a, String b) =>
     a.toLowerCase().compareTo(b.toLowerCase());
+
+/**
+ * Returns a copy of the [input] where the first (a-z) letter of each word is
+ * capitalized.
+ */
+String capitalize(String input) =>
+    input.replaceAllMapped(new RegExp(r'(^| )(\w)'), (Match m) => m.group(0).toUpperCase());
+
+/**
+ * Returns a new string where [replacement] is inserted at the [index] of 
+ * the [original] string.
+ * 
+ * If [overwrite] is given, only the specified number of characters will be
+ * overwritten. (Default: length of [replacement])
+ * 
+ * If the [replacement] is longer than [original], the returned string will
+ * be longer than [original].
+ */
+String replace(String original, int index, String replacement, {int overwrite}) {
+  StringBuffer str = new StringBuffer();
+  if (index > 0) {
+    str.write(original.substring(0, index));
+  }
+
+  if (overwrite == null) {
+    overwrite = replacement.length;
+  }
+
+  str.write(replacement);
+  if (overwrite > 0) {
+    if (overwrite < original.length) {
+      str.write(original.substring(index + overwrite));
+    }
+  } else {
+    str.write(original.substring(index));
+  }
+  return str.toString();
+}
+
+/**
+ * Removes a specified [length] of the [original] string starting from the
+ * given [index].
+ */
+String remove(String original, int index, int length) {
+  return replace(original, index, '', overwrite: length);
+}
+
+/**
+ * Inserts the value of [insertion] at the given [index] character of
+ * the [original] string.
+ */
+String insert(String original, int index, String insertion) {
+  return replace(original, index, insertion, overwrite: 0);
+}
+

pubspec.yaml

@@ -1,5 +1,5 @@
 name: quiver
-version: 0.19.0-dev.3
+version: 0.19.0-dev.4
 authors:
 - Justin Fagnani <justinfagnani@google.com>
 - Yegor Jbanov <yjbanov@google.com>
@@ -9,11 +9,11 @@ authors:
 - John McDole <codefu@google.com>
 description: A set of utility libraries for Dart
 homepage: https://github.com/google/quiver-dart
-documentation: http://google.github.io/quiver-dart/
 environment:
   sdk: '>=1.0.0'
+documentation: http://google.github.io/quiver-dart/
 dependencies:
   path: '>=1.0.0 <2.0.0'
 dev_dependencies:
-  unittest: '>=0.11.0'
   matcher: '>=0.10.0'
+  unittest: '>=0.11.0'

test/strings_test.dart

@@ -311,4 +311,43 @@ main() {
     });
 
   });
+
+  group('capitalize', () {
+    test('should return "This Was A Triumph!" after capitalizing non-capitalized the input string', () {
+      expect(capitalize('this was a triumph!'), 'This Was A Triumph!');
+    });
+  });
+
+  group('insert', () {
+    test('should return "abc" after inserting "b" into the string "ac" at index [1]', () {
+      expect(insert('ac', 1, 'b'), 'abc');
+    });
+  });
+
+  group('replace', () {
+    test('should return "abc" after replacing the index [1] character in the string "adc" with "b" '
+         'with length defaulted to the length of the replacement', () {
+      expect(replace('adc', 1 , 'b'), 'abc');
+    });
+    test('should return "abcde" after replacing the index [1] character in the string "adc" with "bcde" '
+         'with overwrite defaulted to the length of the replacement', () {
+      expect(replace('adc', 1 , 'bcde'), 'abcde');
+    });
+    test('should return "aabbcc" after replacing the index [1] character in the string "abc"'
+         'with "abbc" with overwrite = 1 (1 character overwritten)', () {
+      expect(replace('abc', 1, 'abbc', overwrite: 1), 'aabbcc');
+    });
+  });
+
+  group('remove', () {
+    test('should return "abc" after remvoing the character at index [1] from "abbc"', () {
+      expect(remove('abbc', 1, 1), 'abc');
+    });
+
+    test('should return "abc" after removing 5 characters starting at index [1] from "abbbbbbc"', () {
+      expect(remove('abbbbbbc', 1, 5), 'abc');
+    });
+  });
+
+
 }