gosax下載 - gosax原始碼下載

gosax

其他源碼

1.0.0

下載

戈薩克斯

gosax是用於 XML SAX（Simple API for XML）解析的 Go 函式庫，支援唯讀功能。該程式庫專為高效且記憶體敏感的 XML 解析而設計，從各種來源汲取靈感以提供高效能解析器。

特徵

只讀 SAX 解析：串流和處理 XML 文檔，無需將整個文檔載入記憶體。
高效解析：利用受quick-xml和pkg/json啟發的技術來實現高效能。
SWAR（暫存器內的 SIMD） ：受memchr啟發，快速文字處理的最佳化。
與encoding/xml的相容性：包含將gosax類型與encoding/xml類型橋接的實用程式函數，以便於與使用標準函式庫的現有程式碼輕鬆整合。

基準

 goos: darwin
goarch: arm64
pkg: github.com/orisano/gosax
BenchmarkReader_Event-12    	       5	 211845800 ns/op	1103.30 MB/s	 2097606 B/op	       6 allocs/op

安裝

若要安裝gosax ，請使用go get ：

go get github.com/orisano/gosax

用法

以下是如何使用gosax解析 XML 文件的基本範例：

 package main

import (
	"fmt"
	"log"
	"strings"

	"github.com/orisano/gosax"
)

func main () {
	xmlData := `<root><element>Value</element></root>`
	reader := strings . NewReader ( xmlData )

	r := gosax . NewReader ( reader )
	for {
		e , err := r . Event ()
		if err != nil {
			log . Fatal ( err )
		}
		if e . Type () == gosax . EventEOF {
			break
		}
		fmt . Println ( string ( e . Bytes ))
	}
	// Output:
	// <root>
	// <element>
	// Value
	// </element>
	// </root>
}

與encoding/xml橋接

編碼/xml 使用者的重要注意事項：

從encoding/xml遷移到gosax時，請注意，自關閉標籤的處理方式有所不同。若要模仿encoding/xml行為，請將gosax.Reader.EmitSelfClosingTag設為true 。這可確保自動關閉標籤已正確識別和處理。

使用TokenE

如果您習慣encoding/xml的Token ，請從gosax.TokenE開始。注意：使用gosax.TokenE和gosax.Token會因介面而涉及記憶體分配。

前：

 var dec * xml. Decoder
for {
	tok , err := dec . Token ()
	if err == io . EOF {
		break
	}
	// ...
}

後：

 var dec * gosax. Reader
for {
	tok , err := gosax . TokenE ( dec . Event ())
	if err == io . EOF {
		break
	}
	// ...
}

使用 xmlb

xmlb是gosax的擴展，用於簡化從encoding/xml重寫程式碼。它為XML解析和處理提供了更高效能的橋樑。

前：

 var dec * xml. Decoder
for {
	tok , err := dec . Token ()
	if err == io . EOF {
		break
	}
	switch t := tok .( type ) {
	case xml. StartElement :
		// ...
	case xml. CharData :
		// ...
	case xml. EndElement :
		// ...
	}
}

後：

 var dec * xmlb. Decoder
for {
	tok , err := dec . Token ()
	if err == io . EOF {
		break
	}
	switch tok . Type () {
	case xmlb . StartElement :
		t , _ := tok . StartElement ()
		// ...
	case xmlb . CharData :
		t , _ := tok . CharData ()
		// ...
	case xmlb . EndElement :
		t := tok . EndElement ()
		// ...
	}
}