Contents

module Rack::Accept

  # Represents an HTTP Accept-Language header according to the HTTP 1.1
  # specification, and provides several convenience methods for determining
  # acceptable content languages.
  #
  # http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.4
  class Language

    include Header

    # The name of this header.
    def name
      'Accept-Language'
    end

    # Determines the quality factor (qvalue) of the given +language+.
    def qvalue(language)
      return 1 if @qvalues.empty?
      m = matches(language)
      return 0 if m.empty?
      normalize_qvalue(@qvalues[m.first])
    end

    # Returns an array of languages from this header that match the given
    # +language+, ordered by precedence.
    def matches(language)
      values.select {|v|
        v == language || v == '*' || (language.match(/^(.+?)-/) && v == $1)
      }.sort {|a, b|
        # "*" gets least precedence, any others are compared based on length.
        a == '*' ? -1 : (b == '*' ? 1 : a.length <=> b.length)
      }.reverse
    end

  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
rack-accept-0.4.2	lib/rack/accept/language.rb