Module: ActiveSupport::CoreExtensions::String::Inflections

Included in:
String
Defined in:
lib/active_support/core_ext/string/inflections.rb

Overview

String inflections define new methods on the String class to transform names for different purposes. For instance, you can figure out the name of a database from the name of a class.

"ScaleScore".tableize # => "scale_scores"

Instance Method Summary collapse

Instance Method Details

#camelize(first_letter = :upper) ⇒ Object Also known as: camelcase

By default, camelize converts strings to UpperCamelCase. If the argument to camelize is set to :lower then camelize produces lowerCamelCase.

camelize will also convert ‘/’ to ‘::’ which is useful for converting paths to namespaces.

"active_record".camelize                # => "ActiveRecord"
"active_record".camelize(:lower)        # => "activeRecord"
"active_record/errors".camelize         # => "ActiveRecord::Errors"
"active_record/errors".camelize(:lower) # => "activeRecord::Errors"


44
45
46
47
48
49
# File 'lib/active_support/core_ext/string/inflections.rb', line 44

def camelize(first_letter = :upper)
  case first_letter
    when :upper then Inflector.camelize(self, true)
    when :lower then Inflector.camelize(self, false)
  end
end

#classifyObject

Create a class name from a plural table name like Rails does for table names to models. Note that this returns a string and not a class. (To convert to an actual class follow classify with constantize.)

"egg_and_hams".classify # => "EggAndHam"
"posts".classify        # => "Post"

Singular names are not handled correctly.

"business".classify # => "Busines"


129
130
131
# File 'lib/active_support/core_ext/string/inflections.rb', line 129

def classify
  Inflector.classify(self)
end

#constantizeObject

constantize tries to find a declared constant with the name specified in the string. It raises a NameError when the name is not in CamelCase or is not initialized.

Examples

"Module".constantize # => Module
"Class".constantize  # => Class


161
162
163
# File 'lib/active_support/core_ext/string/inflections.rb', line 161

def constantize
  Inflector.constantize(self)
end

#dasherizeObject

Replaces underscores with dashes in the string.

"puni_puni" # => "puni-puni"


78
79
80
# File 'lib/active_support/core_ext/string/inflections.rb', line 78

def dasherize
  Inflector.dasherize(self)
end

#demodulizeObject

Removes the module part from the constant expression in the string.

"ActiveRecord::CoreExtensions::String::Inflections".demodulize # => "Inflections"
"Inflections".demodulize                                       # => "Inflections"


86
87
88
# File 'lib/active_support/core_ext/string/inflections.rb', line 86

def demodulize
  Inflector.demodulize(self)
end

#foreign_key(separate_class_name_and_id_with_underscore = true) ⇒ Object

Creates a foreign key name from a class name. separate_class_name_and_id_with_underscore sets whether the method should put ‘_’ between the name and ‘id’.

Examples

"Message".foreign_key        # => "message_id"
"Message".foreign_key(false) # => "messageid"
"Admin::Post".foreign_key    # => "post_id"


150
151
152
# File 'lib/active_support/core_ext/string/inflections.rb', line 150

def foreign_key(separate_class_name_and_id_with_underscore = true)
  Inflector.foreign_key(self, separate_class_name_and_id_with_underscore)
end

#humanizeObject

Capitalizes the first word, turns underscores into spaces, and strips ‘_id’. Like titleize, this is meant for creating pretty output.

"employee_salary" # => "Employee salary" 
"author_id"       # => "Author"


138
139
140
# File 'lib/active_support/core_ext/string/inflections.rb', line 138

def humanize
  Inflector.humanize(self)
end

#parameterizeObject

Replaces special characters in a string so that it may be used as part of a ‘pretty’ URL.

Examples

class Person
  def to_param
    "#{id}-#{name.parameterize}"
  end
end

@person = Person.find(1)
# => #<Person id: 1, name: "Donald E. Knuth">

<%= link_to(@person.name, person_path %>
# => <a href="/person/1-donald-e-knuth">Donald E. Knuth</a>


105
106
107
# File 'lib/active_support/core_ext/string/inflections.rb', line 105

def parameterize
  Inflector.parameterize(self)
end

#pluralizeObject

Returns the plural form of the word in the string.

"post".pluralize             # => "posts"
"octopus".pluralize          # => "octopi"
"sheep".pluralize            # => "sheep"
"words".pluralize            # => "words"
"the blue mailman".pluralize # => "the blue mailmen"
"CamelOctopus".pluralize     # => "CamelOctopi"


19
20
21
# File 'lib/active_support/core_ext/string/inflections.rb', line 19

def pluralize
  Inflector.pluralize(self)
end

#singularizeObject

The reverse of pluralize, returns the singular form of a word in a string.

"posts".singularize            # => "post"
"octopi".singularize           # => "octopus"
"sheep".singularize            # => "sheep"
"word".singularize             # => "word"
"the blue mailmen".singularize # => "the blue mailman"
"CamelOctopi".singularize      # => "CamelOctopus"


31
32
33
# File 'lib/active_support/core_ext/string/inflections.rb', line 31

def singularize
  Inflector.singularize(self)
end

#tableizeObject

Creates the name of a table like Rails does for models to table names. This method uses the pluralize method on the last word in the string.

"RawScaledScorer".tableize # => "raw_scaled_scorers"
"egg_and_ham".tableize     # => "egg_and_hams"
"fancyCategory".tableize   # => "fancy_categories"


115
116
117
# File 'lib/active_support/core_ext/string/inflections.rb', line 115

def tableize
  Inflector.tableize(self)
end

#titleizeObject Also known as: titlecase

Capitalizes all the words and replaces some characters in the string to create a nicer looking title. titleize is meant for creating pretty output. It is not used in the Rails internals.

titleize is also aliased as titlecase.

"man from the boondocks".titleize # => "Man From The Boondocks"
"x-men: the last stand".titleize  # => "X Men: The Last Stand"


60
61
62
# File 'lib/active_support/core_ext/string/inflections.rb', line 60

def titleize
  Inflector.titleize(self)
end

#underscoreObject

The reverse of camelize. Makes an underscored, lowercase form from the expression in the string.

underscore will also change ‘::’ to ‘/’ to convert namespaces to paths.

"ActiveRecord".underscore         # => "active_record"
"ActiveRecord::Errors".underscore # => active_record/errors


71
72
73
# File 'lib/active_support/core_ext/string/inflections.rb', line 71

def underscore
  Inflector.underscore(self)
end