Пакет encoding

• import "encoding"
• Обзор
• Указатель
• Подкаталоги

Обзор

Пакет encoding определяет интерфейсы, общие для других пакетов, которые преобразуют данные в байтовые и текстовые представления и обратно. Эти интерфейсы проверяют пакеты encoding/gob, encoding/json и encoding/xml. Благодаря этому реализация интерфейса один раз может сделать тип пригодным для использования с несколькими форматами кодирования. К стандартным типам, реализующим эти интерфейсы, относятся time.Time и net.IP. Интерфейсы образуют пары: одни создают закодированные данные, другие их потребляют.

Добавление методов кодирования/декодирования к существующим типам может нарушить совместимость, поскольку эти методы могут использоваться для сериализации при обмене данными с программами, написанными с другими версиями библиотеки. Политика пакетов, поддерживаемых проектом Go, допускает добавление функций маршалинга, только если подходящего существующего способа маршалинга нет.

Указатель

• тип BinaryAppender
• тип BinaryMarshaler
• тип BinaryUnmarshaler
• тип TextAppender
• тип TextMarshaler
• тип TextUnmarshaler

Файлы пакета

encoding.go

тип BinaryAppender 1.24

BinaryAppender — это интерфейс, реализуемый объектом, который может добавлять своё двоичное представление. Если тип реализует и BinaryAppender, и BinaryMarshaler, то v.MarshalBinary() должен быть семантически идентичен v.AppendBinary(nil).

type BinaryAppender interface {
    // AppendBinary appends the binary representation of itself to the end of b
    // (allocating a larger slice if necessary) and returns the updated slice.
    //
    // Implementations must not retain b, nor mutate any bytes within b[:len(b)].
    AppendBinary(b []byte) ([]byte, error)
}

тип BinaryMarshaler 1.2

BinaryMarshaler — это интерфейс, реализуемый объектом, который может преобразовать себя в двоичное представление.

MarshalBinary кодирует получателя в двоичное представление и возвращает результат.

type BinaryMarshaler interface {
    MarshalBinary() (data []byte, err error)
}

тип BinaryUnmarshaler 1.2

BinaryUnmarshaler — это интерфейс, реализуемый объектом, который может восстановить себя из двоичного представления.

UnmarshalBinary должен уметь декодировать представление, созданное MarshalBinary. Если UnmarshalBinary необходимо сохранить данные после возврата, он должен скопировать их.

type BinaryUnmarshaler interface {
    UnmarshalBinary(data []byte) error
}

тип TextAppender 1.24

TextAppender — это интерфейс, реализуемый объектом, который может добавлять своё текстовое представление. Если тип реализует и TextAppender, и TextMarshaler, то v.MarshalText() должен быть семантически идентичен v.AppendText(nil).

type TextAppender interface {
    // AppendText appends the textual representation of itself to the end of b
    // (allocating a larger slice if necessary) and returns the updated slice.
    //
    // Implementations must not retain b, nor mutate any bytes within b[:len(b)].
    AppendText(b []byte) ([]byte, error)
}

тип TextMarshaler 1.2

TextMarshaler — это интерфейс, реализуемый объектом, который может преобразовать себя в текстовое представление.

MarshalText кодирует получателя в текст в кодировке UTF-8 и возвращает результат.

type TextMarshaler interface {
    MarshalText() (text []byte, err error)
}

тип TextUnmarshaler 1.2

TextUnmarshaler — это интерфейс, реализуемый объектом, который может восстановить себя из текстового представления.

UnmarshalText должен уметь декодировать представление, созданное MarshalText. Если UnmarshalText необходимо сохранить текст после возврата, он должен скопировать его.

type TextUnmarshaler interface {
    UnmarshalText(text []byte) error
}

Подкаталоги