Specifies a new acronym. An acronym must be specified as it will appear in
a camelized string. An underscore string that contains the acronym will
retain the acronym when passed to camelize
,
humanize
, or titleize
. A camelized string that contains the acronym will
maintain the acronym when titleized or humanized, and will convert the
acronym into a non-delimited single lowercase word when passed to
underscore
.
acronym 'HTML' titleize 'html' # => 'HTML' camelize 'html' # => 'HTML' underscore 'MyHTML' # => 'my_html'
The acronym, however, must occur as a delimited unit and not be part of another word for conversions to recognize it:
acronym 'HTTP' camelize 'my_http_delimited' # => 'MyHTTPDelimited' camelize 'https' # => 'Https', not 'HTTPs' underscore 'HTTPS' # => 'http_s', not 'https' acronym 'HTTPS' camelize 'https' # => 'HTTPS' underscore 'HTTPS' # => 'https'
Note: Acronyms that are passed to pluralize
will no longer be
recognized, since the acronym will not occur as a delimited unit in the
pluralized result. To work around this, you must specify the pluralized
form as an acronym as well:
acronym 'API' camelize(pluralize('api')) # => 'Apis' acronym 'APIs' camelize(pluralize('api')) # => 'APIs'
acronym
may be used to specify any word that contains an
acronym or otherwise needs to maintain a non-standard capitalization. The
only restriction is that the word must begin with a capital letter.
acronym 'RESTful' underscore 'RESTful' # => 'restful' underscore 'RESTfulController' # => 'restful_controller' titleize 'RESTfulController' # => 'RESTful Controller' camelize 'restful' # => 'RESTful' camelize 'restful_controller' # => 'RESTfulController' acronym 'McDonald' underscore 'McDonald' # => 'mcdonald' camelize 'mcdonald' # => 'McDonald'
Please login to continue.