跳转至

字符串工具

​ 字符串工具可以便捷的处理字符串,包含去除字符代码、限制字符串长度、估测显示宽度、是否可转数字、是否含中文等功能。

名称 现实时间工具
包路径 util2.basic.string
开发者 kunjinkao_xs

class StrUtil

  • 基类:object
  • 保存和处理字符串的工具

构造函数

StrUtil(input):

  • 参数:
    • input: str - 输入字符串

方法

toString()

  • 转为字符串
  • 返回:str - 设置的字符串

__str__()

  • 与Python内置函数配合,功能同toString()

clone()

  • 克隆当前StrUtil
  • 返回:StrUtil - 克隆后的本类的对象

colorWith(symbol='&')

  • 参数:
    • symbol: str - 颜色符号,默认为&
  • 以颜色符号渲染设置的字符串,修改并返回本对象。可以直接使用§符号避免以使用本方法
  • 返回:StrUtil - 处理后的字符串

hexColor()

  • 对设置的字符串进行16进制色渲染,即形如#000000的颜色代码。
  • 返回:StrUtil - 处理后的字符串

clearColor()

  • 清除设置的字符串的颜色符号,修改并返回本对象。仅适用于普通字符串
  • 返回:StrUtil - 处理后的字符串

limitLength(length)

  • 参数:
    • length: int - 限制的单位长度
  • 限制字符串长度,中文计为2单位,修改并返回本对象
  • 返回:StrUtil - 处理后的字符串

estimateDisplayWidth()

  • 估测字符显示宽度,中文计为2单位
  • 返回:int - 字符显示宽度

isConvertibleToNumber()

  • 判断设置的字符串是否可转为数字(float)
  • 返回:bool - 是否可转为数字

isContainsChinese()

  • 判断设置的字符串是否含中文字符,以\u4e00-\u9fff匹配
  • 返回:bool - 是否含中文字符

splitString(n, color="")

  • 参数:
    • n: int - 步长
    • color: str - §颜色代码,或其他前缀
  • 字符串每n个截为列表的元素,每个元素前加color
  • 返回:list[str] - 按要求处理后的列表

listStrCenter(arr, forceWidth=None)

  • 参数:
    • arr: list - 希望处理的列表
    • forceWidth: 最长字符串的显示宽度,默认None情况下为自行计算
  • 数组按字符串居中对齐
  • 返回:list[str] - 字符串对其后的列表