1// Copyright 2010 The Go Authors. All rights reserved. 2// Use of this source code is governed by a BSD-style 3// license that can be found in the LICENSE file. 4 5package textproto 6 7// A MIMEHeader represents a MIME-style header mapping 8// keys to sets of values. 9type MIMEHeader map[string][]string 10 11// Add adds the key, value pair to the header. 12// It appends to any existing values associated with key. 13func (h MIMEHeader) Add(key, value string) { 14 key = CanonicalMIMEHeaderKey(key) 15 h[key] = append(h[key], value) 16} 17 18// Set sets the header entries associated with key to 19// the single element value. It replaces any existing 20// values associated with key. 21func (h MIMEHeader) Set(key, value string) { 22 h[CanonicalMIMEHeaderKey(key)] = []string{value} 23} 24 25// Get gets the first value associated with the given key. 26// It is case insensitive; [CanonicalMIMEHeaderKey] is used 27// to canonicalize the provided key. 28// If there are no values associated with the key, Get returns "". 29// To use non-canonical keys, access the map directly. 30func (h MIMEHeader) Get(key string) string { 31 if h == nil { 32 return "" 33 } 34 v := h[CanonicalMIMEHeaderKey(key)] 35 if len(v) == 0 { 36 return "" 37 } 38 return v[0] 39} 40 41// Values returns all values associated with the given key. 42// It is case insensitive; [CanonicalMIMEHeaderKey] is 43// used to canonicalize the provided key. To use non-canonical 44// keys, access the map directly. 45// The returned slice is not a copy. 46func (h MIMEHeader) Values(key string) []string { 47 if h == nil { 48 return nil 49 } 50 return h[CanonicalMIMEHeaderKey(key)] 51} 52 53// Del deletes the values associated with key. 54func (h MIMEHeader) Del(key string) { 55 delete(h, CanonicalMIMEHeaderKey(key)) 56} 57