Golang跨平台字符串处理插件库sttr使用指南

sttr是一个强大的Go语言跨平台字符串操作库，它提供了丰富的字符串处理功能，可以方便地在不同操作系统上执行各种字符串转换和操作。

sttr库简介

sttr库的主要特点包括：

• 跨平台支持（Windows/Linux/macOS）
• 丰富的字符串操作功能
• 简洁易用的API设计
• 高性能处理

安装sttr

go get github.com/abdfnx/sttr

基本使用示例

1. 字符串基本操作

package main

import (
	"fmt"
	"github.com/abdfnx/sttr"
)

func main() {
	// 字符串反转
	reversed := sttr.Reverse("hello")
	fmt.Println(reversed) // 输出: olleh

	// 字符串大写
	upper := sttr.UpperCase("hello")
	fmt.Println(upper) // 输出: HELLO

	// 字符串小写
	lower := sttr.LowerCase("HELLO")
	fmt.Println(lower) // 输出: hello
}

2. 编码转换

func encodingExamples() {
	// Base64编码
	encoded := sttr.Base64Encode("hello")
	fmt.Println(encoded) // 输出: aGVsbG8=

	// Base64解码
	decoded, _ := sttr.Base64Decode("aGVsbG8=")
	fmt.Println(decoded) // 输出: hello

	// URL编码
	urlEncoded := sttr.URLEncode("hello world")
	fmt.Println(urlEncoded) // 输出: hello%20world

	// URL解码
	urlDecoded, _ := sttr.URLDecode("hello%20world")
	fmt.Println(urlDecoded) // 输出: hello world
}

3. 哈希计算

func hashExamples() {
	// MD5哈希
	md5Hash := sttr.MD5("hello")
	fmt.Println(md5Hash) // 输出: 5d41402abc4b2a76b9719d911017c592

	// SHA256哈希
	sha256Hash := sttr.SHA256("hello")
	fmt.Println(sha256Hash) // 输出: 2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824
}

4. 高级字符串处理

func advancedStringExamples() {
	// 提取JSON字段
	jsonStr := `{"name":"John","age":30}`
	name, _ := sttr.JSONField(jsonStr, "name")
	fmt.Println(name) // 输出: John

	// 字符串排序
	sorted := sttr.SortLetters("hello")
	fmt.Println(sorted) // 输出: ehllo

	// 移除重复字符
	unique := sttr.RemoveDuplicates("hello")
	fmt.Println(unique) // 输出: helo
}

5. 命令行工具集成

sttr也可以很方便地集成到命令行工具中：

package main

import (
	"fmt"
	"github.com/abdfnx/sttr"
	"os"
)

func main() {
	if len(os.Args) < 3 {
		fmt.Println("Usage: sttr <command> <input>")
		return
	}

	command := os.Args[1]
	input := os.Args[2]

	switch command {
	case "reverse":
		fmt.Println(sttr.Reverse(input))
	case "upper":
		fmt.Println(sttr.UpperCase(input))
	case "lower":
		fmt.Println(sttr.LowerCase(input))
	case "base64":
		fmt.Println(sttr.Base64Encode(input))
	default:
		fmt.Println("Unknown command:", command)
	}
}

性能考虑

sttr在设计时考虑了性能因素，对于大数据量的字符串处理，建议：

1. 复用缓冲区
2. 对于多次操作，考虑链式调用
3. 避免不必要的字符串转换

func performanceExample() {
	// 链式操作示例
	result := sttr.Process("Hello World").
		Reverse().      // dlroW olleH
		LowerCase().   // dlrow olleh
		RemoveSpaces() // dlrowolleh
	
	fmt.Println(result.String())
}

错误处理

sttr中的一些操作可能会返回错误，建议始终检查错误：

func errorHandlingExample() {
	// Base64解码可能失败
	decoded, err := sttr.Base64Decode("invalid base64")
	if err != nil {
		fmt.Println("Decode error:", err)
		return
	}
	fmt.Println(decoded)
}

总结

sttr是一个功能强大且易于使用的Go语言字符串处理库，特别适合需要跨平台支持的场景。它提供了从基本字符串操作到复杂编码转换的各种功能，可以显著提高开发效率。

更多高级功能和详细文档可以参考sttr的GitHub仓库：https://github.com/abdfnx/sttr