Определения типов

Пакет json предоставляет множество типобезопасных типов для обработки результатов JSON операций.

Result[T] -- Унифицированный тип результата

Result[T] -- это обобщённый тип результата операции, обеспечивающий типобезопасную обработку ошибок и доступ к значениям.

Определение структуры

type Result[T any] struct {
    Value  T     // Значение результата
    Exists bool  // Было ли значение найдено
    Error  error // Ошибка (если есть)
}

Методы

Метод	Сигнатура	Описание
`Ok()`	`func (r Result[T]) Ok() bool`	Проверяет, действителен ли результат (без ошибок и найден)
`Unwrap()`	`func (r Result[T]) Unwrap() T`	Возвращает значение, при ошибке возвращает нулевое значение
`UnwrapOr()`	`func (r Result[T]) UnwrapOr(defaultValue T) T`	Возвращает значение или значение по умолчанию

Пример использования

package main

import (
    "fmt"
    "github.com/cybergodev/json"
)

func main() {
    data := `{"user": {"name": "Alice", "age": 30}}`

    // Получение типизированного значения с помощью GetTyped
    name := json.GetTyped[string](data, "user.name")
    fmt.Printf("Имя: %s\n", name)

    // Использование параметра defaultValue для предоставления значения по умолчанию
    nickname := json.GetTyped[string](data, "user.nickname", "Не задано")
    fmt.Printf("Псевдоним: %s\n", nickname)

    age := json.GetTyped[int](data, "user.age", 0)
    fmt.Printf("Возраст: %d\n", age)
}

Соглашения об именовании

GetTyped[T] -- получение значения указанного типа, возвращает T, поддерживает параметр defaultValue
Result[T] -- внутренний тип результата для сценариев, требующих детальной обработки ошибок

CompiledPath -- Предварительно скомпилированный путь

CompiledPath -- это псевдоним типа предварительно скомпилированного JSON пути, используемый для избежания повторного разбора строки пути при частом обращении к одному и тому же пути, повышая производительность.

Определение типа

type CompiledPath = internal.CompiledPath

Сценарий использования

Когда требуется выполнить множество повторяющихся операций с одним и тем же путём (например, массовые запросы в цикле), можно предварительно скомпилировать путь, чтобы избежать повторного разбора строки пути при каждом вызове.

Функция компиляции

Processor.CompilePath

Сигнатура: func (p *Processor) CompilePath(path string) (*CompiledPath, error)

Предварительная компиляция JSON пути через Processor, возвращает экземпляр *CompiledPath, который можно использовать в последующих операциях.

processor, err := json.New()
if err != nil {
    panic(err)
}
defer processor.Close()

compiled, err := processor.CompilePath("user.profile.name")
if err != nil {
    panic(err)
}
// compiled можно использовать повторно в последующих операциях
val, err := processor.GetCompiled(data, compiled)

Совет по производительности

Для высокочастотного повторного доступа к путям предварительная компиляция может значительно сократить расходы на разбор путей. Подходит для массовых операций, циклических запросов и других сценариев.

AccessResult -- Результат доступа к свойству

AccessResult -- это результат безопасного доступа к свойству, обеспечивающий цепочечное преобразование типов.

Определение структуры

type AccessResult struct {
    Value  any    // Значение результата
    Exists bool   // Существует ли путь
    Type   string // Информация о типе во время выполнения (для отладки)
}

Метод создания

Processor.SafeGet

Сигнатура: func (p *Processor) SafeGet(jsonStr, path string, cfg ...Config) AccessResult

Безопасное получение свойства, возвращает AccessResult для цепочечного преобразования типов.

Также можно использовать функцию уровня пакета SafeGet:

Сигнатура: func SafeGet(jsonStr, path string, cfg ...Config) AccessResult

processor, err := json.New()
if err != nil {
    panic(err)
}
defer processor.Close()

result := processor.SafeGet(data, "user.age")

if !result.Exists {
    fmt.Println("Путь не существует")
    return
}

// Проверка типа
fmt.Println("Тип:", result.Type)

Методы цепочечного преобразования типов

Метод	Возвращаемый тип	Описание
`Unwrap()`	`any`	Возвращает значение, nil если не существует
`UnwrapOr(defaultValue)`	`any`	Возвращает значение или значение по умолчанию
`AsString()`	`(string, error)`	Преобразует в строку (строгая проверка типа)
`AsStringConverted()`	`(string, error)`	Форматированное преобразование в строку
`AsInt()`	`(int, error)`	Преобразует в целое число (bool не преобразуется)
`AsFloat64()`	`(float64, error)`	Преобразует в float64 (bool не преобразуется)
`AsBool()`	`(bool, error)`	Преобразует в логическое значение
`Ok()`	`bool`	Проверяет, существует ли значение (возвращает `Exists`)

Примечание

Методы AsInt64(), AsArray(), AsObject() удалены. Используйте GetTyped[T] для получения этих типов.

result := processor.SafeGet(data, "user.profile")

// Цепочечные вызовы
name, _ := result.AsString()
email, _ := result.AsString()
age, _ := result.AsInt()
price, _ := result.AsFloat64()
active, _ := result.AsBool()

// Для типов массива или объекта используйте GetTyped
arr := json.GetTyped[[]any](data, "items")
obj := json.GetTyped[map[string]any](data, "user.profile")

Пример использования

package main

import (
    "fmt"
    "github.com/cybergodev/json"
)

func main() {
    processor, err := json.New()
    if err != nil {
        panic(err)
    }
    defer processor.Close()

    data := `{"user": {"name": "Alice", "age": 30, "active": true}}`

    // Безопасное получение и преобразование
    result := processor.SafeGet(data, "user.age")

    // Непосредственное использование методов AccessResult
    age, err := result.AsInt()
    if err != nil {
        panic(err)
    }
    fmt.Printf("Возраст: %d\n", age)

    // Получение несуществующего пути
    missing := processor.SafeGet(data, "user.nickname")
    if !missing.Exists {
        fmt.Println("Псевдоним не существует")
    }
}

Schema -- Тип JSON Schema

Schema используется для определения правил структурной валидации JSON данных, поддерживает подмножество JSON Schema Draft 7.

Определение структуры

type Schema struct {
    Type                 string            `json:"type,omitempty"`
    Properties           map[string]*Schema `json:"properties,omitempty"`
    Items                *Schema           `json:"items,omitempty"`
    Required             []string          `json:"required,omitempty"`
    MinLength            int               `json:"minLength,omitempty"`
    MaxLength            int               `json:"maxLength,omitempty"`
    Minimum              float64           `json:"minimum,omitempty"`
    Maximum              float64           `json:"maximum,omitempty"`
    Pattern              string            `json:"pattern,omitempty"`
    Format               string            `json:"format,omitempty"`
    AdditionalProperties bool              `json:"additionalProperties,omitempty"`
    MinItems             int               `json:"minItems,omitempty"`
    MaxItems             int               `json:"maxItems,omitempty"`
    UniqueItems          bool              `json:"uniqueItems,omitempty"`
    Enum                 []any             `json:"enum,omitempty"`
    Const                any               `json:"const,omitempty"`
    MultipleOf           float64           `json:"multipleOf,omitempty"`
    ExclusiveMinimum     bool              `json:"exclusiveMinimum,omitempty"`
    ExclusiveMaximum     bool              `json:"exclusiveMaximum,omitempty"`
    Title                string            `json:"title,omitempty"`
    Description          string            `json:"description,omitempty"`
    Default              any               `json:"default,omitempty"`
    Examples             []any             `json:"examples,omitempty"`
}

Создание Schema

Прямое конструирование

schema := &json.Schema{
    Type:     "object",
    Required: []string{"name", "email"},
    Properties: map[string]*json.Schema{
        "name":  {Type: "string", MinLength: 1},
        "email": {Type: "string", Format: "email"},
        "age":   {Type: "integer", Minimum: 0},
    },
}

Использование NewSchemaWithConfig

cfg := json.DefaultSchemaConfig()
cfg.Type = "object"
cfg.Required = []string{"name", "email"}
schema := json.NewSchemaWithConfig(cfg)

Использование DefaultSchema

Сигнатура: func DefaultSchema() *Schema

Возвращает пустой экземпляр Schema с конфигурацией по умолчанию.

schema := json.DefaultSchema()
schema.Type = "object"
schema.Required = []string{"id"}

Структура SchemaConfig

type SchemaConfig struct {
    Type                 string
    Properties           map[string]*Schema
    Items                *Schema
    Required             []string
    MinLength            *int
    MaxLength            *int
    Minimum              *float64
    Maximum              *float64
    Pattern              string
    Format               string
    AdditionalProperties *bool
    MinItems             *int
    MaxItems             *int
    UniqueItems          bool
    Enum                 []any
    Const                any
    MultipleOf           *float64
    ExclusiveMinimum     *bool
    ExclusiveMaximum     *bool
    Title                string
    Description          string
    Default              any
    Examples             []any
}

Пример использования

package main

import (
    "fmt"
    "github.com/cybergodev/json"
)

func main() {
    // Определение Schema с помощью литерала структуры
    schema := &json.Schema{
        Type:     "object",
        Required: []string{"name", "email"},
        Properties: map[string]*json.Schema{
            "name": {
                Type:      "string",
                MinLength: 1,
                MaxLength: 100,
            },
            "email": {
                Type:   "string",
                Format: "email",
            },
            "age": {
                Type:    "integer",
                Minimum: 0,
                Maximum: 150,
            },
        },
        AdditionalProperties: false,
    }

    // Валидация JSON
    data := `{"name": "Alice", "email": "[email protected]", "age": 30}`
    errors, err := json.ValidateSchema(data, schema)
    if err != nil {
        panic(err)
    }

    if len(errors) > 0 {
        for _, e := range errors {
            fmt.Printf("Ошибка валидации [%s]: %s\n", e.Path, e.Message)
        }
    } else {
        fmt.Println("Валидация пройдена")
    }
}

ValidationError

Тип ошибки валидации Schema.

Определение структуры

type ValidationError struct {
    Path    string `json:"path"`    // Путь, где произошла ошибка
    Message string `json:"message"` // Сообщение об ошибке
}

Метод

Error

Сигнатура: func (ve *ValidationError) Error() string

Реализует интерфейс error.

for _, e := range errors {
    fmt.Println(e.Error())
}

BatchOperation

Определение пакетной операции.

Определение структуры

type BatchOperation struct {
    Type    string `json:"type"`     // Тип операции: "get", "set", "delete", "validate"
    JSONStr string `json:"json_str"` // Строка JSON данных
    Path    string `json:"path"`     // Целевой путь
    Value   any    `json:"value"`    // Значение для операции Set
    ID      string `json:"id"`       // Идентификатор операции
}

BatchResult

Результат пакетной операции.

Определение структуры

type BatchResult struct {
    ID     string `json:"id"`     // Идентификатор операции (соответствует BatchOperation.ID)
    Result any    `json:"result"` // Результат операции
    Error  error  `json:"error"`  // Ошибка (если есть)
}

WarmupResult

Результат прогрева кэша.

Определение структуры

type WarmupResult struct {
    TotalPaths  int      `json:"total_paths"`            // Общее количество путей
    Successful  int      `json:"successful"`             // Количество успешно прогретых
    Failed      int      `json:"failed"`                 // Количество неудачных
    SuccessRate float64  `json:"success_rate"`           // Процент успешных
    FailedPaths []string `json:"failed_paths,omitempty"` // Список неудавшихся путей
}

ParsedJSON

Предварительно разобранный JSON документ, может повторно использоваться для многократных операций запроса.

Определение структуры

Внутренние поля ParsedJSON не экспортируются, доступ через методы.

type ParsedJSON struct {
    // Внутренние поля (не экспортируются)
    // Используйте метод Data() для получения разобранных данных
}

Метод Data

Сигнатура: func (p *ParsedJSON) Data() any

Возвращает базовые разобранные данные.

Метод Release

Сигнатура: func (p *ParsedJSON) Release()

Освобождает ресурсы, удерживаемые разобранными данными. Вызывайте, когда ParsedJSON больше не нужен, позволяя базовым ресурсам быть собранными сборщиком мусора.

processor, err := json.New()
if err != nil {
    panic(err)
}
defer processor.Close()

// Предварительный разбор JSON
parsed, err := processor.PreParse(`{"user": {"name": "Alice", "age": 30}}`)
if err != nil {
    panic(err)
}

// Многократные запросы к предварительно разобранному результату
name, _ := processor.GetFromParsed(parsed, "user.name")
age, _ := processor.GetFromParsed(parsed, "user.age")

Сценарии использования

Сценарий	Описание
Высокочастотные запросы	Избегание повторного разбора при многократных запросах к одному JSON
Пакетное получение путей	Использование `GetMultiple` для пакетного получения нескольких путей
Оптимизация производительности	Значительный рост производительности запросов после предварительного разбора

Подсказка по производительности

Для сценариев, требующих многократных запросов к одной строке JSON, использование PreParse для предварительного разбора может значительно повысить производительность, избегая накладных расходов на повторный разбор.

Stats

Статистика процессора.

Определение структуры

type Stats struct {
    CacheSize        int64         `json:"cache_size"`        // Текущий размер кэша
    CacheMemory      int64         `json:"cache_memory"`      // Использование памяти кэшем (байты)
    MaxCacheSize     int           `json:"max_cache_size"`    // Максимальный размер кэша
    HitCount         int64         `json:"hit_count"`         // Количество попаданий в кэш
    MissCount        int64         `json:"miss_count"`        // Количество промахов кэша
    HitRatio         float64       `json:"hit_ratio"`         // Коэффициент попадания в кэш
    CacheTTL         time.Duration `json:"cache_ttl"`         // Время жизни кэша
    CacheEnabled     bool          `json:"cache_enabled"`     // Включён ли кэш
    IsClosed         bool          `json:"is_closed"`         // Закрыт ли процессор
    MemoryEfficiency float64       `json:"memory_efficiency"` // Эффективность памяти
    OperationCount   int64         `json:"operation_count"`   // Общее количество операций
    ErrorCount       int64         `json:"error_count"`       // Общее количество ошибок
}

HealthStatus

Информация о состоянии здоровья.

Определение структуры

type HealthStatus struct {
    Timestamp time.Time              `json:"timestamp"` // Временная метка проверки
    Healthy   bool                   `json:"healthy"`   // Здоров ли
    Checks    map[string]CheckResult `json:"checks"`    // Результаты отдельных проверок
}

Структура CheckResult

type CheckResult struct {
    Healthy bool   `json:"healthy"` // Здорова ли эта проверка
    Message string `json:"message"` // Сообщение проверки
}

IterableValue

Обёртка итерируемого значения.

Обзор методов

Базовый доступ

Метод	Описание
`Get(path)`	Получить значение по пути
`GetString(path)`	Получить строку
`GetInt(path)`	Получить целое число
`GetFloat64(path)`	Получить число с плавающей точкой
`GetBool(path)`	Получить логическое значение
`GetArray(path)`	Получить массив
`GetObject(path)`	Получить объект

Получение со значением по умолчанию

Метод	Описание
`GetWithDefault(path, defaultValue)`	Получить значение, вернуть значение по умолчанию если не существует
`GetStringWithDefault(path, defaultValue)`	Получить строку, вернуть значение по умолчанию если не существует
`GetIntWithDefault(path, defaultValue)`	Получить целое число, вернуть значение по умолчанию если не существует
`GetFloat64WithDefault(path, defaultValue)`	Получить число с плавающей точкой, вернуть значение по умолчанию если не существует
`GetBoolWithDefault(path, defaultValue)`	Получить логическое значение, вернуть значение по умолчанию если не существует

Проверка и обход

Метод	Описание
`Exists(path)`	Проверить, существует ли поле
`IsNull(path)`	Проверить, равно ли null по указанному пути
`IsNullData()`	Проверить, равно ли null базовое значение
`IsEmpty(path)`	Проверить, пусто ли по указанному пути
`IsEmptyData()`	Проверить, пусто ли базовое значение
`GetData()`	Получить исходные базовые данные
`Break()`	Вернуть сигнал прерывания, остановить итерацию
`ForeachNested(path, fn)`	Обойти вложенные структуры
`Release()`	Освободить ресурсы

Подробнее в документации Итераторы.

Типы ошибок кодирования

Пакет json экспортирует следующие типы ошибок в процессе кодирования/декодирования для детальной обработки ошибок.

SyntaxError -- Синтаксическая ошибка

Ошибка разбора JSON синтаксиса, указывающая на то, что входные данные не являются допустимым форматом JSON.

Определение структуры

type SyntaxError struct {
    Offset int64 // Позиция ошибки (смещение в байтах)
    // Содержит другие неэкспортируемые поля
}

Метод

Метод	Сигнатура	Описание
`Error`	`func (e *SyntaxError) Error() string`	Возвращает описание ошибки с указанием смещения

data := `{invalid json}`
_, err := json.ParseAny(data)
if syntaxErr, ok := err.(*json.SyntaxError); ok {
    fmt.Printf("Синтаксическая ошибка, смещение: %d\n", syntaxErr.Offset)
}

UnmarshalTypeError -- Ошибка типа при десериализации

Возвращается, когда значение JSON не может быть преобразовано в целевой тип Go.

Определение структуры

type UnmarshalTypeError struct {
    Value  string       // Описание значения JSON (например, "string", "number")
    Type   reflect.Type // Целевой тип Go
    Offset int64        // Позиция ошибки (смещение в байтах)
    Struct string       // Имя структуры, содержащей поле (если есть)
    Field  string       // Имя поля (если есть)
    Err    error        // Внутренняя ошибка (если есть)
}

Методы

Метод	Сигнатура	Описание
`Error`	`func (e *UnmarshalTypeError) Error() string`	Возвращает описание ошибки несоответствия типов
`Unwrap`	`func (e *UnmarshalTypeError) Unwrap() error`	Возвращает внутреннюю ошибку

type User struct {
    Age int `json:"age"`
}
var user User
err := json.Unmarshal([]byte(`{"age": "not_a_number"}`), &user)
if typeErr, ok := err.(*json.UnmarshalTypeError); ok {
    fmt.Printf("Ошибка типа: значение JSON %s не может быть преобразовано в %v\n", typeErr.Value, typeErr.Type)
}

UnsupportedTypeError -- Ошибка неподдерживаемого типа

Возвращается при попытке кодирования неподдерживаемого типа в Go.

Определение структуры

type UnsupportedTypeError struct {
    Type reflect.Type // Неподдерживаемый тип Go
}

Метод

Метод	Сигнатура	Описание
`Error`	`func (e *UnsupportedTypeError) Error() string`	Возвращает описание неподдерживаемого типа

type Chan chan int
data := Chan(make(chan int))
_, err := json.Marshal(data)
if unsupportedErr, ok := err.(*json.UnsupportedTypeError); ok {
    fmt.Printf("Неподдерживаемый тип: %v\n", unsupportedErr.Type)
}

UnsupportedValueError -- Ошибка неподдерживаемого значения

Возвращается при попытке кодирования неподдерживаемого значения (например, NaN, Infinity).

Определение структуры

type UnsupportedValueError struct {
    Value reflect.Value // Неподдерживаемое значение
    Str   string        // Описание ошибки
}

Метод

Метод	Сигнатура	Описание
`Error`	`func (e *UnsupportedValueError) Error() string`	Возвращает описание неподдерживаемого значения

val := math.NaN()
_, err := json.Marshal(val)
if valErr, ok := err.(*json.UnsupportedValueError); ok {
    fmt.Printf("Неподдерживаемое значение: %s\n", valErr.Str)
}

InvalidUnmarshalError -- Ошибка недопустимой цели десериализации

Возвращается, когда целевой аргумент Unmarshal не является указателем или равен nil.

Определение структуры

type InvalidUnmarshalError struct {
    Type reflect.Type // Тип целевого аргумента
}

Метод

Метод	Сигнатура	Описание
`Error`	`func (e *InvalidUnmarshalError) Error() string`	Возвращает описание ошибки недопустимой цели

var target string // Следует передать указатель
err := json.Unmarshal([]byte(`"hello"`), target) // Ошибка: указатель не передан
if invalidErr, ok := err.(*json.InvalidUnmarshalError); ok {
    fmt.Printf("Недопустимая цель десериализации: %v\n", invalidErr.Type)
}

MarshalerError -- Ошибка кодировщика

Оборачивает ошибку, когда метод MarshalJSON или MarshalText типа возвращает ошибку.

Определение структуры

type MarshalerError struct {
    Type reflect.Type // Тип, реализующий MarshalJSON или MarshalText
    Err  error        // Ошибка, возвращённая MarshalJSON или MarshalText
    // Содержит другие неэкспортируемые поля
}

Методы

Метод	Сигнатура	Описание
`Error`	`func (e *MarshalerError) Error() string`	Возвращает описание ошибки кодировщика
`Unwrap`	`func (e *MarshalerError) Unwrap() error`	Возвращает внутреннюю ошибку

type BadMarshaler struct{}

func (BadMarshaler) MarshalJSON() ([]byte, error) {
    return nil, errors.New("marshal failed")
}

_, err := json.Marshal(BadMarshaler{})
if marshalErr, ok := err.(*json.MarshalerError); ok {
    fmt.Printf("Ошибка кодировщика (тип: %v): %v\n", marshalErr.Type, marshalErr.Err)
}

Encoder -- JSON кодировщик

Encoder записывает JSON значения в выходной поток. 100% совместим с encoding/json.Encoder.

Создание

Сигнатура: func NewEncoder(w io.Writer, cfg ...Config) *Encoder

Создаёт кодировщик, записывающий в w. Поддерживает необязательный параметр Config для настройки поведения кодирования.

file, _ := os.Create("output.json")
defer file.Close()

encoder := json.NewEncoder(file)
err := encoder.Encode(map[string]any{"name": "Alice"})

Методы

Метод	Сигнатура	Описание
`Encode`	`func (enc *Encoder) Encode(v any) error`	Кодирует значение Go в JSON и записывает в поток
`SetEscapeHTML`	`func (enc *Encoder) SetEscapeHTML(on bool)`	Устанавливает, следует ли экранировать специальные HTML символы
`SetIndent`	`func (enc *Encoder) SetIndent(prefix, indent string)`	Устанавливает формат отступа

Пример использования

package main

import (
    "bytes"
    "fmt"
    "github.com/cybergodev/json"
)

func main() {
    var buf bytes.Buffer
    encoder := json.NewEncoder(&buf)
    encoder.SetIndent("", "  ")
    encoder.SetEscapeHTML(true)

    err := encoder.Encode(map[string]any{
        "name":  "Alice",
        "email": "[email protected]",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(buf.String())
}

Decoder -- JSON декодер

Decoder читает и декодирует JSON значения из входного потока. 100% совместим с encoding/json.Decoder.

Создание

Сигнатура: func NewDecoder(r io.Reader, cfg ...Config) *Decoder

Создаёт декодер, читающий из r. Поддерживает необязательный параметр Config.

file, _ := os.Open("data.json")
defer file.Close()

decoder := json.NewDecoder(file)
for decoder.More() {
    var obj map[string]any
    if err := decoder.Decode(&obj); err != nil {
        break
    }
    fmt.Println(obj)
}

Методы

Метод	Сигнатура	Описание
`Decode`	`func (dec *Decoder) Decode(v any) error`	Читает следующее JSON значение из потока и декодирует
`UseNumber`	`func (dec *Decoder) UseNumber()`	Декодер будет разбирать числа как `Number` вместо `float64`
`DisallowUnknownFields`	`func (dec *Decoder) DisallowUnknownFields()`	Возвращает ошибку при обнаружении неизвестных полей при декодировании
`Buffered`	`func (dec *Decoder) Buffered() io.Reader`	Возвращает Reader с оставшимися данными в буфере декодера
`InputOffset`	`func (dec *Decoder) InputOffset() int64`	Возвращает смещение текущей позиции ввода
`More`	`func (dec *Decoder) More() bool`	Проверяет, есть ли ещё JSON значения в потоке
`Token`	`func (dec *Decoder) Token() (Token, error)`	Читает следующий JSON token

Пример использования

package main

import (
    "fmt"
    "strings"
    "github.com/cybergodev/json"
)

func main() {
    input := `{"name":"Alice","age":30}{"name":"Bob","age":25}`
    decoder := json.NewDecoder(strings.NewReader(input))

    for decoder.More() {
        var person map[string]any
        if err := decoder.Decode(&person); err != nil {
            break
        }
        fmt.Printf("Имя: %s, Возраст: %v\n", person["name"], person["age"])
    }
}

Пример потокового декодирования

package main

import (
    "fmt"
    "strings"
    "github.com/cybergodev/json"
)

func main() {
    // Декодирование нескольких значений из JSON потока
    input := `[1,2,3][4,5,6]`
    decoder := json.NewDecoder(strings.NewReader(input))

    for decoder.More() {
        var arr []any
        if err := decoder.Decode(&arr); err != nil {
            panic(err)
        }
        fmt.Println(arr)
    }
}

Пример чтения Token

decoder := json.NewDecoder(strings.NewReader(`{"name":"Alice"}`))
for {
    token, err := decoder.Token()
    if err != nil {
        break
    }
    switch v := token.(type) {
    case json.Delim:
        fmt.Printf("Разделитель: %s\n", string(v))
    case string:
        fmt.Printf("Строка: %s\n", v)
    case float64:
        fmt.Printf("Число: %v\n", v)
    case bool:
        fmt.Printf("Логическое: %v\n", v)
    case nil:
        fmt.Println("null")
    }
}

Token -- JSON Token

Token -- это значение JSON token, содержащее один из следующих типов:

Delim, представляющий четыре JSON разделителя [ ] { }
bool, представляющий JSON логическое значение
float64, представляющий JSON число
Number, представляющий JSON число когда включён UseNumber
string, представляющий JSON строку
nil, представляющий JSON null

type Token any

Получается через Decoder.Token().

Number -- JSON число

Number представляет строку JSON числа, используется Decoder при включённом режиме UseNumber.

type Number string

Методы

Метод	Сигнатура	Описание
`String`	`func (n Number) String() string`	Возвращает строковое представление числа
`Float64`	`func (n Number) Float64() (float64, error)`	Преобразует в float64
`Int64`	`func (n Number) Int64() (int64, error)`	Преобразует в int64

decoder := json.NewDecoder(strings.NewReader(`{"price": 19.99}`))
decoder.UseNumber()
var obj map[string]any
decoder.Decode(&obj)

if num, ok := obj["price"].(json.Number); ok {
    f, _ := num.Float64()
    fmt.Println(f) // 19.99
}

Delim -- JSON разделитель

Delim -- это тип JSON разделителя, соответствующий четырём символам [, ], {, }.

type Delim rune

Метод

String

Сигнатура: func (d Delim) String() string

Возвращает строковое представление разделителя.

token, _ := decoder.Token()
if delim, ok := token.(json.Delim); ok {
    fmt.Println(delim.String()) // "[" или "{" и т.д.
}

Смотрите также

Функции пакета - Справочник функций уровня пакета
Config - Параметры конфигурации
Processor - Методы процессора
Определения интерфейсов - Расширяемые интерфейсы

Определения типов ​

Result[T] -- Унифицированный тип результата ​

Определение структуры ​

Методы ​

Пример использования ​

CompiledPath -- Предварительно скомпилированный путь ​

Определение типа ​

Сценарий использования ​

Функция компиляции ​

Processor.CompilePath ​

AccessResult -- Результат доступа к свойству ​

Определение структуры ​

Метод создания ​

Processor.SafeGet ​

Методы цепочечного преобразования типов ​

Пример использования ​

Schema -- Тип JSON Schema ​

Определение структуры ​

Создание Schema ​

Прямое конструирование ​

Использование NewSchemaWithConfig ​

Использование DefaultSchema ​

Структура SchemaConfig ​

Пример использования ​

ValidationError ​

Определение структуры ​

Метод ​

Error ​

BatchOperation ​

Определение структуры ​

BatchResult ​

Определение структуры ​

WarmupResult ​

Определение структуры ​

ParsedJSON ​

Определение структуры ​

Метод Data ​

Метод Release ​

Сценарии использования ​

Stats ​

Определение структуры ​

HealthStatus ​

Определение структуры ​

Структура CheckResult ​

IterableValue ​

Обзор методов ​

Типы ошибок кодирования ​

SyntaxError -- Синтаксическая ошибка ​

Определение структуры ​

Метод ​

UnmarshalTypeError -- Ошибка типа при десериализации ​

Определение структуры ​

Методы ​

UnsupportedTypeError -- Ошибка неподдерживаемого типа ​

Определение структуры ​

Метод ​

UnsupportedValueError -- Ошибка неподдерживаемого значения ​

Определение структуры ​

Метод ​

InvalidUnmarshalError -- Ошибка недопустимой цели десериализации ​

Определение структуры ​

Метод ​

MarshalerError -- Ошибка кодировщика ​

Определение структуры ​

Методы ​

Encoder -- JSON кодировщик ​

Создание ​

Методы ​

Пример использования ​

Decoder -- JSON декодер ​

Создание ​

Методы ​

Пример использования ​

Пример потокового декодирования ​

Пример чтения Token ​

Token -- JSON Token ​

Number -- JSON число ​

Методы ​

Delim -- JSON разделитель ​

Метод ​

Определения типов

Result[T] -- Унифицированный тип результата

Определение структуры

Методы

Пример использования

CompiledPath -- Предварительно скомпилированный путь

Определение типа

Сценарий использования

Функция компиляции

Processor.CompilePath

AccessResult -- Результат доступа к свойству

Определение структуры

Метод создания

Processor.SafeGet

Методы цепочечного преобразования типов

Пример использования

Schema -- Тип JSON Schema

Определение структуры

Создание Schema

Прямое конструирование

Использование NewSchemaWithConfig

Использование DefaultSchema

Структура SchemaConfig

Пример использования

ValidationError

Определение структуры

Метод

Error

BatchOperation

Определение структуры

BatchResult

Определение структуры

WarmupResult

Определение структуры

ParsedJSON

Определение структуры

Метод Data

Метод Release

Сценарии использования

Stats

Определение структуры

HealthStatus

Определение структуры

Структура CheckResult

IterableValue

Обзор методов

Типы ошибок кодирования

SyntaxError -- Синтаксическая ошибка

Определение структуры

Метод

UnmarshalTypeError -- Ошибка типа при десериализации

Определение структуры

Методы

UnsupportedTypeError -- Ошибка неподдерживаемого типа

Определение структуры

Метод

UnsupportedValueError -- Ошибка неподдерживаемого значения

Определение структуры

Метод

InvalidUnmarshalError -- Ошибка недопустимой цели десериализации

Определение структуры

Метод

MarshalerError -- Ошибка кодировщика

Определение структуры

Методы

Encoder -- JSON кодировщик

Создание

Методы

Пример использования

Decoder -- JSON декодер

Создание

Методы

Пример использования

Пример потокового декодирования

Пример чтения Token

Token -- JSON Token

Number -- JSON число

Методы

Delim -- JSON разделитель

Метод