# Scm.Text

**Repository Path**: openscm/scm.text

## Basic Information

- **Project Name**: Scm.Text
- **Description**: 适用于C#的字符串扩展工具类库
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-05
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Scm.Text

## 介绍
Scm.Text 是一个用于文本处理和转换的 C# 类库，提供了丰富的字符串操作、编码解码、数据格式化等功能。这个库旨在简化常见的文本处理任务，提高开发效率。

## 软件架构
该项目采用 .NET Framework 构建，主要包含以下组件：
- **TextExts**: 提供了扩展方法，用于对象到 JSON/XML 字符串的转换、价格/体积/重量的格式化等。
- **TextUtils**: 提供了静态方法，用于字符串处理、编码解码、数据验证、随机字符串生成等。

## 安装教程
1. 从 release 目录获取 `Scm.Common.Text.dll` 文件。
2. 在你的项目中引用该 DLL 文件。

## 使用说明
以下是一些常见用法示例：

### 字符串格式化
```csharp
// 格式化价格
int price = 12345;
string formattedPrice = price.ToPrice(); // 输出 "123.45"

// 格式化体积
int volume = 123456;
string formattedVolume = volume.ToVolume(); // 输出 "123.456"
```

### 编码解码
```csharp
// Base64 编码
string base64Encoded = TextUtils.Base64Encode(System.Text.Encoding.UTF8.GetBytes("Hello World"));

// Base64 解码
byte[] decodedBytes = TextUtils.Base64Decode(base64Encoded);
string decodedString = System.Text.Encoding.UTF8.GetString(decodedBytes); // 输出 "Hello World"

// Base32 编码
string base64Encoded = TextUtils.Base32Encode(System.Text.Encoding.UTF8.GetBytes("Hello World"));

// Base32 解码
byte[] decodedBytes = TextUtils.Base32Decode(base64Encoded);
string decodedString = System.Text.Encoding.UTF8.GetString(decodedBytes); // 输出 "Hello World"
```

### 对象转换
```csharp
// 字符串转JSON
string jsonString="YOUR JSON STRING";
var jsonObject = jsonString.AsJsonObject<T>();

// 对象转JSON字符串
var jsonObject = yourObject;
var jsonString = jsonObject.ToJsonString();

// 对象深复制
var obj1 = yourObject;
var obj2 = obj1.Clone<T>();

// 对象浅复制
var obj1 = yourObject;
var obj2 = obj1.Adept<T>();
```

### 数据验证
```csharp
// 检查是否为有效的电子邮件地址
bool isValidEmail = TextUtils.IsEmail("example@example.com"); // 返回 true

// 检查是否为有效的手机号码
bool isValidCellphone = TextUtils.IsCellphone("13800138000"); // 返回 true
```

### 随机字符串生成
```csharp
// 生成随机数字字符串（默认长度为6）
string randomNumber = TextUtils.RandomNumber(); // 输出类似 "123456"

// 生成随机字母字符串（默认长度为8，包含大写字母）
string randomString = TextUtils.RandomString(); // 输出类似 "ABCD1234"
```

## 参与贡献
1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 特技
1. 使用 Readme_XXX.md 来支持不同的语言，例如 Readme_en.md, Readme_zh.md
2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)