Contents

class String
  # Truncates a given +text+ after a given <tt>length</tt> if +text+ is longer than <tt>length</tt>:
  #
  #   'Once upon a time in a world far far away'.truncate(27)
  #   # => "Once upon a time in a wo..."
  #
  # Pass a string or regexp <tt>:separator</tt> 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 <tt>:omission</tt> string (defaults to "...")
  # for a total length not exceeding <tt>length</tt>:
  #
  #   'And they found that many people were sleeping better.'.truncate(25, omission: '... (continued)')
  #   # => "And they f... (continued)"
  def truncate(truncate_at, options = {})
    return dup unless length > truncate_at

    omission = options[:omission] || '...'
    length_with_room_for_omission = truncate_at - omission.length
    stop = \
      if options[:separator]
        rindex(options[:separator], length_with_room_for_omission) || length_with_room_for_omission
      else
        length_with_room_for_omission
      end

    "#{self[0, stop]}#{omission}"
  end
end

Version data entries

151 entries across 151 versions & 2 rubygems

Version	Path
fastlane_core-0.42.0	lib/fastlane_core/string_filters.rb
fastlane_core-0.41.3	lib/fastlane_core/string_filters.rb
fastlane_core-0.41.2	lib/fastlane_core/string_filters.rb
fastlane_core-0.41.1	lib/fastlane_core/string_filters.rb
fastlane_core-0.41.0	lib/fastlane_core/string_filters.rb
fastlane_core-0.40.0	lib/fastlane_core/string_filters.rb
fastlane_core-0.39.1	lib/fastlane_core/string_filters.rb
fastlane_core-0.39.0	lib/fastlane_core/string_filters.rb
fastlane_core-0.38.0	lib/fastlane_core/string_filters.rb
fastlane_core-0.37.0	lib/fastlane_core/string_filters.rb
fastlane_core-0.36.9	lib/fastlane_core/string_filters.rb