ianaindex

Documentation

Overview

Package ianaindex maps names to Encodings as specified by the IANA registry. This includes both the MIME and IANA names.

See http://www.iana.org/assignments/character-sets/character-sets.xhtml for more details.

Index

• type Index
  • func (x *Index) Get(name string) (encoding.Encoding, error)
  • func (x *Index) Name(e encoding.Encoding) (string, error)

Examples

• Index

Types

type Index

type Index struct {
}

Index maps names registered by IANA to Encodings.

Example

package main

import (
	"fmt"

	"golang.org/x/text/encoding/charmap"
	"golang.org/x/text/encoding/ianaindex"
)

func main() {
	fmt.Println(ianaindex.MIME.Name(charmap.ISO8859_7))

	fmt.Println(ianaindex.IANA.Name(charmap.ISO8859_7))

	e, _ := ianaindex.IANA.Get("cp437")
	fmt.Println(ianaindex.IANA.Name(e))

	// TODO: Output:
	// ISO-8859-7
	// ISO8859_7:1987
	// IBM437
}

var (
	// MIME is an index to map MIME names. It does not support aliases.
	MIME *Index

	// IANA is an index that supports all names and aliases using IANA names as
	// the canonical identifier.
	IANA *Index
)

func (*Index) Get

func (x *Index) Get(name string) (encoding.Encoding, error)

Get returns an Encoding for IANA-registered names. Matching is case-insensitive.

func (*Index) Name

func (x *Index) Name(e encoding.Encoding) (string, error)

Name reports the canonical name of the given Encoding. It will return an error if the e is not associated with a known encoding scheme.