method
truncate
v7.1.3.2 -
Show latest stable
- Class:
String
truncate(truncate_to, options = {})public
Truncates a given text to length truncate_to if text is longer than truncate_to:
'Once upon a time in a world far far away'.truncate(27) # => "Once upon a time in a wo..."
Pass a string or regexp :separator to truncate text at a natural break:
'Once upon a time in a world far far away'.truncate(27, separator: ' ') # => "Once upon a time in a..." 'Once upon a time in a world far far away'.truncate(27, separator: /\s/) # => "Once upon a time in a..."
The last characters will be replaced with the :omission string (defaults to “…”). The total length will not exceed truncate_to unless both text and :omission are longer than truncate_to:
'And they found that many people were sleeping better.'.truncate(25, omission: '... (continued)') # => "And they f... (continued)" 'And they found that many people were sleeping better.'.truncate(4, omission: '... (continued)') # => "... (continued)"
1Note
Examples out of order
The second and third examples should exchange places to fit with their explanations.