Home > Features, General > Rails Snippet: Write like Orwell with to_sentence

Rails Snippet: Write like Orwell with to_sentence

A few weeks ago I posted an article that explained how to create a comma separated list from a hash of objects. When I was browsing the Rails API documentation I came across a method named to_sentence.

What this little bugger does is create a human readable, comma separated list of items in an array or hash. But the big difference here is that you can specify what the last separator must be. By default this is set to ‘and’. See the following example.

@users = User.find(:all)
@users.collect {|u| u.firstname}.to_sentence
=> "Tom, Dick, and Harry"

Of you course, you can specify the last separator, called the connector. Also it’s possible to not show the last comma.

@users.collect {|u| u.firstname}.to_sentence(:connector => "and of course,", :skip_last_comma => true)
=> "tom, Dick and of course, Harry"

I bet this will greatly simplify the way you list names, tags, categories or whatever else you want summed up in a comma separated list with a human touch.

Please share the love of this post by bookmarking it, and sharing it with others. Thanks!

  • Digg
  • del.icio.us
  • description
  • Reddit
  • Facebook
  • E-mail this story to a friend!
  • TwitThis

  1. carlos
    May 24th, 2008 at 05:55 | #1

    How do you handle elements being empty? How do you avoid a comma without text. the first field in my array is required but the other two are not

  2. May 24th, 2008 at 08:07 | #2

    @carlos: if they are nil values, you can issue compact, which will remove any nil values.

    ["carlos", nil, "ariejan"].compact 
    => ["carlos", "ariejan"]

    If you are talking about blank (empty string) values, you can issue a select (which will also weed out the nil values)

    ["carlos", nil, "", "ariejan"].select { |name| !name.blank? }
    => ["carlos", "ariejan"]
  3. July 3rd, 2008 at 14:10 | #3

    Brilliant! I was just writing my own version of this when i thought, “Hang on a minute, maybe Rails can already do this for me!” Sure enough … it can! :)

    Thanks for the little tutorial!

  1. No trackbacks yet.