| // Copyright 2015 The Go Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style |
| // license that can be found in the LICENSE file. |
| |
| // Package htmlindex maps character set encoding names to Encodings as |
| // recommended by the W3C for use in HTML 5. See http://www.w3.org/TR/encoding. |
| package htmlindex |
| |
| // TODO: perhaps have a "bare" version of the index (used by this package) that |
| // is not pre-loaded with all encodings. Global variables in encodings prevent |
| // the linker from being able to purge unneeded tables. This means that |
| // referencing all encodings, as this package does for the default index, links |
| // in all encodings unconditionally. |
| // |
| // This issue can be solved by either solving the linking issue (see |
| // https://github.com/golang/go/issues/6330) or refactoring the encoding tables |
| // (e.g. moving the tables to internal packages that do not use global |
| // variables). |
| |
| // TODO: allow canonicalizing names |
| |
| import ( |
| "golang.org/x/text/encoding" |
| "golang.org/x/text/language" |
| ) |
| |
| // LanguageDefault returns the canonical name of the default encoding for a |
| // given language. |
| func LanguageDefault(tag language.Tag) string { |
| // Note: we'll use the map defined in the W3C spec. |
| panic("TODO: implement") |
| } |
| |
| // Get returns an Encoding for one of the names listed in |
| // http://www.w3.org/TR/encoding using the Default Index. Matching is case- |
| // insensitive. |
| func Get(name string) (encoding.Encoding, error) { |
| panic("TODO: implement") |
| } |
| |
| // Name reports the canonical name of the given Encoding. It will return |
| // an error if e is not associated with a supported encoding scheme. |
| func Name(e encoding.Encoding) (string, error) { |
| panic("TODO: implement") |
| } |