accept

Documentation

Overview

Package header provides functions for parsing HTTP headers.

Index

• func Copy(header http.Header) http.Header
• func Negotiate(hk string, h http.Header, offers []string, defaultOffer string) string
• func ParseList(header http.Header, key string) []string
• func ParseTime(header http.Header, key string) time.Time
• func ParseValueAndParams(header http.Header, key string) (value string, params map[string]string)
• type AcceptSpec
  • func Parse(header http.Header, key string) (specs []AcceptSpec)

Functions

func Copy

func Copy(header http.Header) http.Header

Copy returns a shallow copy of the header.

func Negotiate

func Negotiate(hk string, h http.Header, offers []string, defaultOffer string) string

Negotiate returns the best offered content type for the request's Accept header. If two offers match with equal weight, then the more specific offer is preferred. For example, text/* trumps */*. If two offers match with equal weight and specificity, then the offer earlier in the list is preferred. If no offers match, then defaultOffer is returned.

func ParseList

func ParseList(header http.Header, key string) []string

ParseList parses a comma separated list of values. Commas are ignored in quoted strings. Quoted values are not unescaped or unquoted. Whitespace is trimmed.

func ParseTime

func ParseTime(header http.Header, key string) time.Time

ParseTime parses the header as time. The zero value is returned if the header is not present or there is an error parsing the header.

func ParseValueAndParams

func ParseValueAndParams(header http.Header, key string) (value string, params map[string]string)

ParseValueAndParams parses a comma separated list of values with optional semicolon separated name-value pairs. Content-Type and Content-Disposition headers are in this format.

Types

type AcceptSpec

type AcceptSpec struct {
	Value string
	Q     float64
}

AcceptSpec describes an Accept* header.

func Parse

func Parse(header http.Header, key string) (specs []AcceptSpec)

Parse parses Accept* kind headers.