Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

encoding

package module

Go to main page

Versions in this module

v0

v0.3.0

Jul 14, 2025

v0.2.0

Jul 13, 2025

Changes in this version

+ type DetectionCandidate struct

+ Confidence float64

+ ConvertedText string

+ Encoding string

+ Method string

+ Score float64

type Detector

+ SmartDetectEncoding func(data []byte) (*DetectionResult, error)

type Processor

+ func NewSmartProcessor(config ...*ProcessorConfig) Processor

+ func NewZipFileProcessor() Processor

v0.1.0

Jul 13, 2025

Changes in this version

+ const DefaultBackupSuffix

+ const DefaultBufferSize

+ const DefaultCacheSize

+ const DefaultCacheTTL

+ const DefaultChunkSize

+ const DefaultInvalidChar

+ const DefaultMaxFileSize

+ const DefaultMinConfidence

+ const DefaultSampleSize

+ const EncodingBIG5

+ const EncodingCP866

+ const EncodingEUCJP

+ const EncodingEUCKR

+ const EncodingGB18030

+ const EncodingGB2312

+ const EncodingGBK

+ const EncodingISO88591

+ const EncodingISO885915

+ const EncodingISO88592

+ const EncodingISO88595

+ const EncodingKOI8R

+ const EncodingMacintosh

+ const EncodingShiftJIS

+ const EncodingUTF16

+ const EncodingUTF16BE

+ const EncodingUTF16LE

+ const EncodingUTF32

+ const EncodingUTF32BE

+ const EncodingUTF32LE

+ const EncodingUTF8

+ const EncodingWindows1250

+ const EncodingWindows1251

+ const EncodingWindows1252

+ const EncodingWindows1254

+ const LineEndingCR

+ const LineEndingCRLF

+ const LineEndingLF

+ const OperationConvert

+ const OperationDetect

+ const OperationProcess

+ const OperationValidate

+ var ErrConversionFailed = errors.New("encoding conversion failed")

+ var ErrDetectionFailed = errors.New("encoding detection failed")

+ var ErrFileNotFound = errors.New("file not found")

+ var ErrFileTooLarge = errors.New("file too large")

+ var ErrInsufficientMemory = errors.New("insufficient memory")

+ var ErrInvalidConfiguration = errors.New("invalid configuration")

+ var ErrInvalidInput = errors.New("invalid input data")

+ var ErrPermissionDenied = errors.New("permission denied")

+ var ErrUnsupportedEncoding = errors.New("unsupported encoding")

+ func NewDefaultWithMetrics() (Processor, MetricsCollector)

+ type ConvertResult struct

+ BytesProcessed int64

+ ConversionTime time.Duration

+ Data []byte

+ SourceEncoding string

+ TargetEncoding string

+ type Converter interface

+ Convert func(data []byte, from, to string) ([]byte, error)

+ ConvertString func(text, from, to string) (string, error)

+ ConvertToUTF8 func(data []byte, from string) ([]byte, error)

+ func NewConverter(config ...*ConverterConfig) Converter

+ type ConverterConfig struct

+ BufferSize int

+ ChunkSize int64

+ InvalidCharReplacement string

+ MaxMemoryUsage int64

+ NormalizeLineEndings bool

+ PreserveBOM bool

+ StrictMode bool

+ TargetLineEnding string

+ func GetDefaultConverterConfig() *ConverterConfig

+ type DetectionResult struct

+ Confidence float64

+ Details map[string]interface{}

+ Encoding string

+ Language string

+ type Detector interface

+ DetectBestEncoding func(data []byte) (string, error)

+ DetectEncoding func(data []byte) (*DetectionResult, error)

+ DetectFileEncoding func(filename string) (*DetectionResult, error)

+ func NewDetector(config ...*DetectorConfig) Detector

+ type DetectorConfig struct

+ CacheSize int

+ CacheTTL time.Duration

+ EnableCache bool

+ EnableLanguageDetection bool

+ MinConfidence float64

+ PreferredEncodings []string

+ SampleSize int

+ SupportedEncodings []string

+ func GetDefaultDetectorConfig() *DetectorConfig

+ type EncodingError struct

+ Encoding string

+ Err error

+ File string

+ Op string

+ func (e *EncodingError) Error() string

+ func (e *EncodingError) Unwrap() error

+ type FileOperationError struct

+ Err error

+ File string

+ Op string

+ func (e *FileOperationError) Error() string

+ func (e *FileOperationError) Unwrap() error

+ type FileProcessOptions struct

+ BackupSuffix string

+ BufferSize int

+ CreateBackup bool

+ DryRun bool

+ MinConfidence float64

+ OverwriteExisting bool

+ PreserveMode bool

+ PreserveTime bool

+ TargetEncoding string

+ type FileProcessResult struct

+ BackupFile string

+ BytesProcessed int64

+ DetectionConfidence float64

+ InputFile string

+ OutputFile string

+ ProcessingTime time.Duration

+ SourceEncoding string

+ TargetEncoding string

+ type FileProcessor interface

+ ProcessFile func(inputFile, outputFile string, options *FileProcessOptions) (*FileProcessResult, error)

+ ProcessFileInPlace func(file string, options *FileProcessOptions) (*FileProcessResult, error)

+ ProcessFileToBytes func(filename, targetEncoding string) ([]byte, error)

+ ProcessFileToString func(filename, targetEncoding string) (string, error)

+ func NewDefaultFile() FileProcessor

+ func NewFileProcessor(config *ProcessorConfig) FileProcessor

+ type Logger interface

+ Debug func(msg string, fields ...interface{})

+ Error func(msg string, fields ...interface{})

+ Info func(msg string, fields ...interface{})

+ Warn func(msg string, fields ...interface{})

+ type MetricsCollector interface

+ GetStats func() *ProcessingStats

+ RecordError func(operation string, err error)

+ RecordOperation func(operation string, duration time.Duration)

+ ResetStats func()

+ func NewMetricsCollector() MetricsCollector

+ type ProcessingStats struct

+ AverageProcessingSpeed float64

+ EncodingDistribution map[string]int64

+ FailedOperations int64

+ LastUpdateTime time.Time

+ StartTime time.Time

+ SuccessOperations int64

+ TotalBytes int64

+ TotalOperations int64

+ TotalProcessingTime time.Duration

+ type Processor interface

+ SmartConvert func(data []byte, target string) (*ConvertResult, error)

+ SmartConvertString func(text, target string) (*StringConvertResult, error)

+ func NewDefault() Processor

+ func NewForBatchProcessing() Processor

+ func NewForCLI() Processor

+ func NewForWebService() Processor

+ func NewHighPerformance() Processor

+ func NewMemoryEfficient() Processor

+ func NewProcessor(config *ProcessorConfig) Processor

+ func NewQuick() Processor

+ func NewStrictMode() Processor

+ func NewTolerantMode() Processor

+ func NewWithConfig(detectorConfig *DetectorConfig, converterConfig *ConverterConfig) Processor

+ func NewWithLogger(logger Logger) Processor

+ type ProcessorConfig struct

+ ConverterConfig *ConverterConfig

+ DetectorConfig *DetectorConfig

+ EnableMetrics bool

+ LogLevel string

+ Logger Logger

+ MaxFileSize int64

+ TempDir string

+ func GetDefaultProcessorConfig() *ProcessorConfig

+ type StreamOptions struct

+ BufferSize int

+ DetectionSampleSize int

+ SkipBOM bool

+ SourceEncoding string

+ StrictMode bool

+ TargetEncoding string

+ type StreamProcessor interface

+ ProcessReader func(ctx context.Context, r io.Reader, sourceEncoding, targetEncoding string) (io.Reader, error)

+ ProcessReaderWriter func(ctx context.Context, r io.Reader, w io.Writer, options *StreamOptions) (*StreamResult, error)

+ ProcessWriter func(ctx context.Context, w io.Writer, sourceEncoding, targetEncoding string) (io.Writer, error)

+ func NewDefaultStream() StreamProcessor

+ func NewStreamProcessor(config *ProcessorConfig) StreamProcessor

+ type StreamResult struct

+ BytesRead int64

+ BytesWritten int64

+ ErrorCount int

+ ProcessingTime time.Duration

+ SourceEncoding string

+ TargetEncoding string

+ type StringConvertResult struct

+ BytesProcessed int64

+ ConversionTime time.Duration

+ SourceEncoding string

+ TargetEncoding string

+ Text string