apppublic/aidocs/strUtils.md

strUtils 模块技术文档

---

概述

strUtils 是一个简单的 Python 工具模块，提供对字符串进行左右空格去除的基本功能。该模块包含三个函数：

• rtrim(ss)：去除字符串右侧的空格。
• ltrim(ss)：去除字符串左侧的空格。
• lrtrim(ss)：同时去除字符串左右两侧的空格。

这些函数不依赖外部库，适用于基础字符串处理场景。

---

函数说明

rtrim(ss)

功能

去除输入字符串右侧的所有空格字符（' '），保留其余部分。

参数

• ss (str): 待处理的字符串。

返回值

• (str): 去除右侧空格后的字符串。若原字符串为空，返回空字符串。

示例

rtrim("hello   ")  # 返回 "hello"
rtrim("  hello  ")  # 返回 "  hello"
rtrim("")          # 返回 ""

实现逻辑

1. 若输入字符串为空，直接返回。
2. 使用循环检查字符串最后一个字符是否为空格，若是则切片去除最后一个字符，重复此过程直到末尾非空格为止。

---

ltrim(ss)

功能

去除输入字符串左侧的所有空格字符（' '），保留其余部分。

参数

• ss (str): 待处理的字符串。

返回值

• (str): 去除左侧空格后的字符串。若原字符串为空，返回空字符串。

示例

ltrim("   hello")  # 返回 "hello"
ltrim("  hello  ")  # 返回 "hello  "
ltrim("")          # 返回 ""

实现逻辑

1. 若输入字符串为空，直接返回。
2. 使用循环检查字符串第一个字符是否为空格，若是则切片去除第一个字符，重复此过程直到开头非空格为止。

---

lrtrim(ss)

功能

同时去除输入字符串左侧和右侧的所有空格字符。

参数

• ss (str): 待处理的字符串。

返回值

• (str): 去除左右空格后的字符串。若原字符串为空，返回空字符串。

示例

lrtrim("   hello   ")  # 返回 "hello"
lrtrim("  hi there  ")  # 返回 "hi there"
lrtrim("")             # 返回 ""

实现逻辑

1. 先调用 ltrim(ss) 去除左侧空格。
2. 再对结果调用 rtrim(s) 去除右侧空格。
3. 返回最终结果。

注意：该函数等效于 Python 内置的 str.strip()，但此处为手动实现。

---

使用示例

# 导入模块（假设保存为 strUtils.py）
from strUtils import *

text = "   Hello World   "

print(repr(rtrim(text)))   # '   Hello World'
print(repr(ltrim(text)))   # 'Hello World   '
print(repr(lrtrim(text)))  # 'Hello World'

---

注意事项

• 本模块仅处理空格字符（' '），不处理其他空白字符（如制表符 \t、换行符 \n 等）。
• 对于大字符串或高频调用场景，建议使用 Python 内置方法 str.strip(), str.lstrip(), str.rstrip()，性能更优。
• 输入参数应为字符串类型，否则可能引发 IndexError 或 TypeError。

---

版本信息

• 创建时间：2025年4月
• 作者：匿名
• 许可：公共领域 / 自由使用

---

扩展建议

未来可扩展如下功能：

• 支持去除多种空白字符（使用 string.whitespace）。
• 添加 trim_all(ss) 函数用于去除所有连续空格并压缩为单个空格。
• 增加类型检查与异常处理机制。

---

✅ 提示：虽然此模块可用于学习字符串操作原理，但在生产环境中推荐优先使用 Python 内置的 strip 系列方法。