Ember.String Class
Defines string helper methods including string formatting and localization.
Unless Ember.EXTEND_PROTOTYPES.String is false these methods will also be
added to the String.prototype as well.
Item Index
Methods
Methods
camelize
        - 
                        
str 
Returns the lowerCamelCase form of a string.
'innerHTML'.camelize();          // 'innerHTML'
'action_name'.camelize();        // 'actionName'
'css-class-name'.camelize();     // 'cssClassName'
'my favorite items'.camelize();  // 'myFavoriteItems'
'My Favorite Items'.camelize();  // 'myFavoriteItems'
    Parameters:
- 
                        
strStringThe string to camelize.
 
Returns:
the camelized string.
capitalize
        - 
                        
str 
Returns the Capitalized form of a string
'innerHTML'.capitalize()         // 'InnerHTML'
'action_name'.capitalize()       // 'Action_name'
'css-class-name'.capitalize()    // 'Css-class-name'
'my favorite items'.capitalize() // 'My favorite items'
    Parameters:
- 
                        
strStringThe string to capitalize.
 
Returns:
The capitalized string.
classify
        - 
                        
str 
Returns the UpperCamelCase form of a string.
'innerHTML'.classify();          // 'InnerHTML'
'action_name'.classify();        // 'ActionName'
'css-class-name'.classify();     // 'CssClassName'
'my favorite items'.classify();  // 'MyFavoriteItems'
    Parameters:
- 
                        
strStringthe string to classify
 
Returns:
the classified string
dasherize
        - 
                        
str 
Replaces underscores, spaces, or camelCase with dashes.
'innerHTML'.dasherize();          // 'inner-html'
'action_name'.dasherize();        // 'action-name'
'css-class-name'.dasherize();     // 'css-class-name'
'my favorite items'.dasherize();  // 'my-favorite-items'
    Parameters:
- 
                        
strStringThe string to dasherize.
 
Returns:
the dasherized string.
decamelize
        - 
                        
str 
Converts a camelized string into all lower case separated by underscores.
'innerHTML'.decamelize();           // 'inner_html'
'action_name'.decamelize();        // 'action_name'
'css-class-name'.decamelize();     // 'css-class-name'
'my favorite items'.decamelize();  // 'my favorite items'
    Parameters:
- 
                        
strStringThe string to decamelize.
 
Returns:
the decamelized string.
fmt
        - 
                        
str - 
                        
formats 
Apply formatting options to the string. This will look for occurrences of "%@" in your string and substitute them with the arguments you pass into this method. If you want to control the specific order of replacement, you can add a number after the key as well to indicate which argument you want to insert.
Ordered insertions are most useful when building loc strings where values you need to insert may appear in different orders.
"Hello %@ %@".fmt('John', 'Doe');     // "Hello John Doe"
"Hello %@2, %@1".fmt('John', 'Doe');  // "Hello Doe, John"
    Parameters:
- 
                        
strStringThe string to format
 - 
                        
formatsArrayAn array of parameters to interpolate into string.
 
Returns:
formatted string
htmlSafe
        ()
        
            Handlebars.SafeString
        
        static
    
    Mark a string as safe for unescaped output with Handlebars. If you return HTML from a Handlebars helper, use this function to ensure Handlebars does not escape the HTML.
Ember.String.htmlSafe('<div>someString</div>')
    Returns:
a string that will not be html escaped by Handlebars
loc
        - 
                        
str - 
                        
formats 
Formats the passed string, but first looks up the string in the localized
strings hash. This is a convenient way to localize text. See
Ember.String.fmt() for more information on formatting.
Note that it is traditional but not required to prefix localized string keys with an underscore or other character so you can easily identify localized strings.
Ember.STRINGS = {
  '_Hello World': 'Bonjour le monde',
  '_Hello %@ %@': 'Bonjour %@ %@'
};
Ember.String.loc("_Hello World");  // 'Bonjour le monde';
Ember.String.loc("_Hello %@ %@", ["John", "Smith"]);  // "Bonjour John Smith";
    Parameters:
- 
                        
strStringThe string to format
 - 
                        
formatsArrayOptional array of parameters to interpolate into string.
 
Returns:
formatted string
underscore
        - 
                        
str 
More general than decamelize. Returns the lower_case_and_underscored form of a string.
'innerHTML'.underscore();          // 'inner_html'
'action_name'.underscore();        // 'action_name'
'css-class-name'.underscore();     // 'css_class_name'
'my favorite items'.underscore();  // 'my_favorite_items'
    Parameters:
- 
                        
strStringThe string to underscore.
 
Returns:
the underscored string.
w
        - 
                        
str 
Splits a string into separate units separated by spaces, eliminating any
empty strings in the process. This is a convenience method for split that
is mostly useful when applied to the String.prototype.
Ember.String.w("alpha beta gamma").forEach(function(key) {
  console.log(key);
});
// > alpha
// > beta
// > gamma
    Parameters:
- 
                        
strStringThe string to split
 
Returns:
array containing the split strings
