v3.0.0 - Show latest stable - 1 note - Class: String
truncate(length, options = {}) public

Truncates a given text after a given length if text is longer than length:

  "Once upon a time in a world far far away".truncate(27)
  # => "Once upon a time in a wo..."

The last characters will be replaced with the :omission string (defaults to "…") for a total length not exceeding :length:

  "Once upon a time in a world far far away".truncate(27, :separator => ' ')
  # => "Once upon a time in a..."

Pass a :separator to truncate text at a natural break:

  "And they found that many people were sleeping better.".truncate(25, :omission => "... (continued)")
  # => "And they f... (continued)"
Show source
Register or log in to add new notes.
August 4, 2011
1 thank

Examples out of order

The second and third examples should exchange places to fit with their explanations.