iconv: libiconv for go
iconv is a libiconv wrapper for go. libiconv Convert string to requested character encoding.
iconv project's homepage is: https://github.com/go-iconv/iconv.
Fork from : https://github.com/qiniu/iconv.
why go-iconv?
support gopkg.in API
Document
See http://godoc.org/gopkg.in/iconv.v1
Note: Open returns a conversion descriptor cd, cd contains a conversion state and can not be used in multiple threads simultaneously.
Install
go get gopkg.in/iconv.v1
Example
Convert string
package main
import (
"fmt"
"gopkg.in/iconv.v1"
)
func main() {
cd, err := iconv.Open("gbk", "utf-8") // convert utf-8 to gbk
if err != nil {
fmt.Println("iconv.Open failed!")
return
}
defer cd.Close()
gbk := cd.ConvString("你好，世界！")
fmt.Println(gbk)
}
Output to io.Writer
package main
import (
"fmt"
"gopkg.in/iconv.v1"
)
func main() {
cd, err := iconv.Open("gbk", "utf-8") // convert utf-8 to gbk
if err != nil {
fmt.Println("iconv.Open failed!")
return
}
defer cd.Close()
output := ... // eg. output := os.Stdout, ouput, err := os.Create(file)
autoSync := false // buffered or not
bufSize := 0 // default if zero
w := iconv.NewWriter(cd, output, bufSize, autoSync)
fmt.Fprintln(w, "你好，世界！")
w.Sync() // if autoSync = false, you need call Sync() by yourself
}
Input from io.Reader
package main
import (
"fmt"
"io"
"os"
"gopkg.in/iconv.v1"
)
func main() {
cd, err := iconv.Open("utf-8", "gbk") // convert gbk to utf8
if err != nil {
fmt.Println("iconv.Open failed!")
return
}
defer cd.Close()
input := ... // eg. input := os.Stdin, input, err := os.Open(file)
bufSize := 0 // default if zero
r := iconv.NewReader(cd, input, bufSize)
_, err = io.Copy(os.Stdout, r)
if err != nil {
fmt.Println("\nio.Copy failed:", err)
return
}
}