This function negotiates the clients preferred charset based on its
Accept-Charset HTTP header. The qualifier is recognized and charsets
without qualifier are rated highest.
Parameters
supported
array containing the supported charsets as values
result
will be filled with an array containing the negotiation results
Return Values
Returns the negotiated charset or the default charset (i.e. first array entry) if none match.