1219

How do I take a string and convert it to lower or upper case in Ruby?

0

11 Answers 11

1766

Ruby has a few methods for changing the case of strings. To convert to lowercase, use downcase:

"hello James!".downcase    #=> "hello james!"

Similarly, upcase capitalizes every letter and capitalize capitalizes the first letter of the string but lowercases the rest:

"hello James!".upcase      #=> "HELLO JAMES!"
"hello James!".capitalize  #=> "Hello james!"
"hello James!".titleize    #=> "Hello James!" (Rails/ActiveSupport only)

If you want to modify a string in place, you can add an exclamation point to any of those methods:

string = "hello James!"
string.downcase!
string   #=> "hello james!"

Refer to the documentation for String for more information.

4
  • 4
    Watch out! looks to me like using the bang "!" will return nil if there's no capital letter. so str = "this".downcase! returns str = nil Nov 2, 2012 at 22:29
  • 16
    Oftentimes, "bang methods" return nil; you should use them if you want to change an object in place, not if you want to store the value in another variable. Nov 2, 2012 at 23:28
  • but it'is a problem in "i" char if you are using utf-8. For instance, string = FEN BİLİMLERİ. string.capitalize must be "Fen bİlİmlerİ" or it could be changed because of css font style choice.
    – eayurt
    Jan 3, 2013 at 12:01
  • 'coração'.upcase produces 'CORAçãO'. It may be advised to use some gem like “unicode_utils“, “activesupport“ or “Unicode”. Apr 24, 2016 at 22:55
128

You can find out all the methods available on a String by opening irb and running:

"MyString".methods.sort

And for a list of the methods available for strings in particular:

"MyString".own_methods.sort

I use this to find out new and interesting things about objects which I might not otherwise have known existed.

10
  • 12
    The only problem with this answer is that #own_methods doesn't appear to exist. Is it from an Irb extension? Feb 1, 2012 at 23:38
  • 12
    Hi - I thought I was learning something new with the #own_methods then, but it doesn't exist for me either. However, I usually go: ("MyString".methods - Object.merhods).sort
    – oceanician
    May 9, 2012 at 17:04
  • 2
    Very similar to the patch @fakeleft referenced, and I have it in my .irbrc file. I monkey patch Object and create #own_methds with this: (obj.methods - obj.class.superclass.instance_methods).sort
    – mlambie
    Feb 3, 2013 at 18:34
  • 1
    @Laser The methods for String in particular are the ones defined in the String class itself. The methods available on a String include the ones defined in its superclass(es).
    – anon
    May 15, 2015 at 0:47
  • 1
    Use String.public_instance_methods(false) to find all public instance methods specifically defined by String.
    – 3limin4t0r
    Nov 15, 2019 at 22:41
41

Like @endeR mentioned, if internationalization is a concern, the unicode_utils gem is more than adequate.

$ gem install unicode_utils
$ irb
> require 'unicode_utils'
=> true
> UnicodeUtils.downcase("FEN BİLİMLERİ", :tr)
=> "fen bilimleri"

String manipulations in Ruby 2.4 are now unicode-sensitive.

0
23

The ruby downcase method returns a string with its uppercase letters replaced by lowercase letters.

"string".downcase

https://ruby-doc.org/core-2.1.0/String.html#method-i-downcase

2
15

... and the uppercase is:

"Awesome String".upcase
=> "AWESOME STRING"
14

The Rails Active Support gem provides upcase, downcase, swapcase,capitalize, etc. methods with internationalization support:

gem install activesupport
irb -ractive_support/core_ext/string
"STRING  ÁÂÃÀÇÉÊÍÓÔÕÚ".mb_chars.downcase.to_s
 => "string  áâãàçéêíóôõú"
"string  áâãàçéêíóôõú".mb_chars.upcase.to_s
=> "STRING  ÁÂÃÀÇÉÊÍÓÔÕÚ"
8

The .swapcase method transforms the uppercase letters in a string to lowercase and the lowercase letters to uppercase.

'TESTING'.swapcase #=> testing
'testing'.swapcase #=> TESTING
1
  • 2
    Thanks! This is exactly what I was looking for. A mixed case string might make it more obvious exactly what this method does... 'Testing'.swapcase #=> tESTING
    – Matthew
    May 29, 2019 at 19:38
2

You can find strings method like "strings".methods You can define string as upcase, downcase, titleize. For Example,

"hii".downcase
"hii".titleize
"hii".upcase
1

Since Ruby 2.4 there is a built in full Unicode case mapping. Source: https://stackoverflow.com/a/38016153/888294. See Ruby 2.4.0 documentation for details: https://ruby-doc.org/core-2.4.0/String.html#method-i-downcase

1

Won't work for every, but this just saved me a bunch of time. I just had the problem with a CSV returning "TRUE or "FALSE" so I just added VALUE.to_s.downcase == "true" which will return the boolean true if the value is "TRUE" and false if the value is "FALSE", but will still work for the boolean true and false.

0

In combination with try method, to support nil value:

'string'.try(:upcase)
'string'.try(:capitalize)
'string'.try(:titleize)

Not the answer you're looking for? Browse other questions tagged or ask your own question.