Added titleCase()-Method

Author: pbihler

README.md

@@ -786,6 +786,24 @@ S('*').times(3).s //'***'
 ```
 
 
+### - titleCase() ###
+
+Returns a string with the first letter of each word uppercased, including hyphenated words
+
+Example:
+
+```javascript
+S('Like ice in the sunshine').titleCase().s // 'Like Ice In The Sunshine'
+S('data_rate').titleCase().s // 'Data_Rate'
+S('background-color').titleCase().s // 'Background-Color'
+S('-moz-something').titleCase().s // '-Moz-Something'
+S('_car_speed_').titleCase().s // '_Car_Speed_'
+S('yes_we_can').titleCase().s // 'Yes_We_Can
+
+S('   capitalize dash-CamelCase_underscore trim  ').humanize().titleCase().s // 'Capitalize Dash Camel Case Underscore Trim'
+```
+
+
 ### - toBoolean() / toBool()
 
 Converts a a logical truth string to boolean. That is: `true`, `1`, `'true'`, `'on'`, or `'yes'`.
@@ -1082,6 +1100,7 @@ If you contribute to this library, just modify `string.js`, `string.test.js`, an
 - [*] [James Manning](https://github.com/jamesmanning)
 - [*] [Nathan Friedly](https://github.com/nfriedly)
 - [*] [Alison Rowland](https://github.com/arowla)
+- [*] [Pascal Bihler](https://github.com/pbihler)
 
 
 

lib/string.js

@@ -451,6 +451,18 @@ string.js - Copyright (C) 2012-2014, JP Richardson <[email protected]>
     times: function(n) {
       return new this.constructor(new Array(n + 1).join(this.s));
     },
+    
+    titleCase: function() {
+      var s = this.s;
+      if (s) {
+        s = s.replace(/(^[a-z]| [a-z]|-[a-z]|_[a-z])/g, 
+          function($1){
+            return $1.toUpperCase();
+          }
+        );
+      }
+      return new this.constructor(s);
+    },
 
     toBoolean: function() {
       if (typeof this.orig === 'string') {

test/string.test.js

@@ -614,6 +614,31 @@
         T (S('*').times(3).s === '***');
       })
     })
+ 
+    describe('- titleCase()', function() {
+      it('should upperCase all words in a camel cased string', function() {
+        EQ (S('dataRate').titleCase().s, 'DataRate')
+        EQ (S('CarSpeed').titleCase().s, 'CarSpeed')
+        EQ (S('yesWeCan').titleCase().s, 'YesWeCan')
+        EQ (S('backgroundColor').titleCase().s, 'BackgroundColor')
+      })
+      it('should upperCase all words in a string with spaces, underscores, or dashes', function() {
+        EQ (S('Like ice in the sunshine').titleCase().s, 'Like Ice In The Sunshine')
+        EQ (S('data_rate').titleCase().s, 'Data_Rate')
+        EQ (S('background-color').titleCase().s, 'Background-Color')
+        EQ (S('-moz-something').titleCase().s, '-Moz-Something')
+        EQ (S('_car_speed_').titleCase().s, '_Car_Speed_')
+        EQ (S('yes_we_can').titleCase().s, 'Yes_We_Can')
+      })
+      it('can be combined with humanize to create nice titles out of ugly developer strings', function() {
+        EQ (S('   capitalize dash-CamelCase_underscore trim  ').humanize().titleCase().s, 'Capitalize Dash Camel Case Underscore Trim')
+      })
+      it('does not fail on edge cases', function () {
+        EQ (S('').titleCase().s,'')
+        EQ (S(null).titleCase().s,null)
+        EQ (S(undefined).titleCase().s,undefined)
+      })
+    })
 
     describe('- toFloat([precision])', function() {
       it('should return the float value, wraps parseFloat', function() {