class Protocol::HTTP::Headers::Merged

Used for merging objects into a sequential list of headers. Normalizes header keys and values.

def << headers

@parameter headers [Headers | Array | Hash] A list of headers to add.

Add a new set of headers to the merged list. 
def << headers
	@all << headers
	
	return self
end

def clear

Clear the references to all headers. 
def clear
	@all.clear
end

def each(&block)

@parameter value [String] The header value.
@parameter key [String] The header key (lower case).
@yields {|key, value| ...} The header key and value.

Enumerate all headers in the merged list. 
def each(&block)
	return to_enum unless block_given?
	
	@all.each do |headers|
		headers.each do |key, value|
			yield key.to_s.downcase, value.to_s
		end
	end
end

def fields

@returns [Array] A list of all headers, in the order they were added, as `[key, value]` pairs. 
def fields
	each.to_a
end

def flatten

@returns [Headers] A new instance of {Headers} containing all the merged headers. 
def flatten
	Headers.new(fields)
end

def initialize(*all)

@parameter *all [Array] An array of all headers to merge.

Construct a merged list of headers. 
def initialize(*all)
	@all = all
end