Bitbybit Docs
    Preparing search index...

    Class TextBitByBit

    处理文本：拆分、连接、搜索、去除首尾空白、填充、更改大小写、正则表达式以及带占位符的格式化。vectorChar 和 vectorText 用简单的笔画字体将文本变成线条路径，因此文字可以变成几何体。文本中的位置从 0 开始计数。

    Index

    Constructors

    constructor

    create

    create

    query

    includes startsWith endsWith indexOf lastIndexOf charAt length isEmpty

    regex

    regexTest regexMatch regexReplace regexSearch regexSplit

    transform

    split replaceAll join toString toStringEach format substring slice trim trimStart trimEnd padStart padEnd toUpperCase toLowerCase toUpperCaseFirst toLowerCaseFirst repeat reverse concat

    vector

    vectorChar vectorText

    Constructors

    create

    • 原样传递文本，使一个值可以被命名并重用。

      示例：'Hello World' -> 'Hello World'

      Parameters

      Returns string

      同一段文本

    query

    • 判断文本是否包含搜索文本。

      示例：'hello world' 包含 'world' -> true

      Parameters

      Returns boolean

      当搜索文本出现在其中时为 true

      const has = bitbybit.text.includes({ text: "hello world", search: "world" });

    • 判断文本是否以搜索文本开头。

      示例：'hello world' 以 'hello' 开头 -> true

      Parameters

      Returns boolean

      当文本以其开头时为 true

      const starts = bitbybit.text.startsWith({ text: "hello world", search: "hello" });

    • 判断文本是否以搜索文本结尾。

      示例：'hello world' 以 'world' 结尾 -> true

      Parameters

      Returns boolean

      当文本以其结尾时为 true

      const ends = bitbybit.text.endsWith({ text: "hello world", search: "world" });

    • 找出搜索文本第一次出现的位置，字符从 0 开始计数，未出现时为 -1。

      示例：'hello world' 查找 'world' -> 6

      Parameters

      Returns number

      第一次出现的位置，或 -1

      const at = bitbybit.text.indexOf({ text: "hello world", search: "world" });

    • 找出搜索文本最后一次出现的位置，字符从 0 开始计数，未出现时为 -1。

      示例：'hello world hello' 查找 'hello' -> 12

      Parameters

      Returns number

      最后一次出现的位置，或 -1

      const at = bitbybit.text.lastIndexOf({ text: "hello world hello", search: "hello" });

    • 读取某位置的字符，从 0 开始计数。

      示例：'hello' 位置 1 -> 'e'

      Parameters

      Returns string

      该字符，位置超出文本时为空文本

      const second = bitbybit.text.charAt({ text: "hello", index: 1 });

    • 统计文本中的字符数。

      示例：'hello' -> 5

      Parameters

      Returns number

      字符数量

    • 判断文本是否为空或只包含空白。

      示例：' ' -> true，'a' -> false

      Parameters

      Returns boolean

      当只有空白时为 true

    regex

    • 判断正则表达式是否在文本中的某处匹配。

      示例：'hello123' 对 '[0-9]+' -> true

      Parameters

      Returns boolean

      当模式匹配时为 true

      const hasDigits = bitbybit.text.regexTest({ text: "hello123", pattern: "[0-9]+", flags: "" });

    • 找出文本中正则表达式匹配的部分。

      带 g 标志时列出每个匹配；不带时只有第一个匹配及其捕获组。无匹配时给出 null。 示例：'hello123world456' 对 '[0-9]+' 带 'g' -> ['123', '456']

      Parameters

      Returns string[]

      匹配结果，没有匹配时为 null

      const numbers = bitbybit.text.regexMatch({ text: "hello123world456", pattern: "[0-9]+", flags: "g" });

    • 将正则表达式匹配的内容替换为另一个文本。

      带 g 标志时替换每个匹配；不带时只替换第一个。 示例：'hello123world456' 对 '[0-9]+' 带 'g'，替换为 'X' -> 'helloXworldX'

      Parameters

      Returns string

      完成替换后的文本

      const clean = bitbybit.text.regexReplace({ text: "hello123world456", pattern: "[0-9]+", flags: "g", replaceWith: "X" });

    • 找出正则表达式第一次匹配的位置，字符从 0 开始计数，不匹配时为 -1。

      示例：'hello123' 对 '[0-9]+' -> 5

      Parameters

      Returns number

      第一个匹配的位置，或 -1

      const at = bitbybit.text.regexSearch({ text: "hello123", pattern: "[0-9]+", flags: "" });

    • 在正则表达式匹配的每一处将文本切成几段；匹配本身被丢弃。

      示例：'a1b2c3' 按 '[0-9]+' 拆分 -> ['a', 'b', 'c', '']

      Parameters

      Returns string[]

      各片段，按顺序排列

      const letters = bitbybit.text.regexSplit({ text: "a1b2c3", pattern: "[0-9]+", flags: "" });

    transform

    • 在分隔符出现的每一处将文本切成几段；分隔符本身被丢弃。

      示例：'apple,banana,cherry' 按 ',' 拆分 -> ['apple', 'banana', 'cherry']

      Parameters

      Returns string[]

      各片段，按顺序排列

      const parts = bitbybit.text.split({ text: "apple,banana,cherry", separator: "," });

    • 将搜索文本的每次出现替换为另一个文本。

      示例：'hello hello' 将 'hello' 替换为 'hi' -> 'hi hi'

      Parameters

      Returns string

      完成替换后的文本

      const greeting = bitbybit.text.replaceAll({ text: "hello hello", search: "hello", replaceWith: "hi" });

    • 将文本列表连接成一个，相邻文本之间放分隔符。

      示例：['apple', 'banana', 'cherry'] 用 ', ' 连接 -> 'apple, banana, cherry'

      Parameters

      Returns string

      连接后的文本

      const line = bitbybit.text.join({ list: ["apple", "banana"], separator: ", " });

    • 按 JavaScript 打印的方式将任意值转成文本。

      示例：42 -> '42'，[1, 2] -> '1,2'

      Type Parameters

      • T

      Parameters

      Returns string

      以文本表示的值

    • 按 JavaScript 打印的方式将列表的每一项转成文本。

      示例：[1, 2.5, true] -> ['1', '2.5', 'true']

      Type Parameters

      • T

      Parameters

      Returns string[]

      每项一段文本，按顺序排列

    • 用值填充文本中的编号占位符：{0} 取第一个值，{1} 取第二个，依此类推。

      没有值的占位符保持原样。 示例：'Point: ({0}, {1})' 配 [10, 5] -> 'Point: (10, 5)'

      Parameters

      Returns string

      填充后的文本

      const label = bitbybit.text.format({ text: "Point: ({0}, {1})", values: ["10", "5"] });

    • 取从起始位置到结束位置（不含）的字符。

      起始大于结束时两者互换，负位置算作 0。 示例：'hello world' 从 0 到 5 -> 'hello'

      Parameters

      Returns string

      该范围内的字符

      const word = bitbybit.text.substring({ text: "hello world", start: 0, end: 5 });

    • 取从起始位置到结束位置（不含）的字符。

      与 substring 不同，负位置从文本末尾计数。 示例：'hello world' 从 0 到 5 -> 'hello'；从 -5 -> 'world'

      Parameters

      Returns string

      该范围内的字符

      const tail = bitbybit.text.slice({ text: "hello world", start: 6, end: 11 });

    • 移除文本两端的空格、制表符和换行符。

      示例：' hello ' -> 'hello'

      Parameters

      Returns string

      去除首尾空白后的文本

    • 移除文本开头的空格、制表符和换行符。

      示例：' hello ' -> 'hello '

      Parameters

      Returns string

      去除开头空白后的文本

    • 移除文本末尾的空格、制表符和换行符。

      示例：' hello ' -> ' hello'

      Parameters

      Returns string

      去除末尾空白后的文本

    • 在前面添加填充文本直到文本达到某长度；已有该长度的文本保持不变。

      示例：'x' 到长度 3 用 'a' -> 'aax'

      Parameters

      • inputs: TextPadDto

        文本、要达到的长度和填充内容

      Returns string

      填充后的文本

      const padded = bitbybit.text.padStart({ text: "7", length: 3, padString: "0" });

    • 在后面添加填充文本直到文本达到某长度；已有该长度的文本保持不变。

      示例：'x' 到长度 3 用 'a' -> 'xaa'

      Parameters

      • inputs: TextPadDto

        文本、要达到的长度和填充内容

      Returns string

      填充后的文本

      const padded = bitbybit.text.padEnd({ text: "x", length: 3, padString: "a" });

    • 将每个字母变为大写。

      示例：'hello' -> 'HELLO'

      Parameters

      Returns string

      大写形式的文本

    • 将每个字母变为小写。

      示例：'HELLO' -> 'hello'

      Parameters

      Returns string

      小写形式的文本

    • 将第一个字符变为大写，其余保持原样。

      示例：'hello world' -> 'Hello world'

      Parameters

      Returns string

      首字符大写的文本

    • 将第一个字符变为小写，其余保持原样。

      示例：'Hello World' -> 'hello World'

      Parameters

      Returns string

      首字符小写的文本

    • 将文本首尾相接重复若干次。

      示例：'ha' 三次 -> 'hahaha'

      Parameters

      Returns string

      重复后的文本

      const laugh = bitbybit.text.repeat({ text: "ha", count: 3 });

    • 反转字符的顺序。

      示例：'hello' -> 'olleh'

      Parameters

      Returns string

      反转后的文本

    • 将多个文本连接成一个，中间没有任何内容。

      示例：['hello', ' ', 'world'] -> 'hello world'

      Parameters

      Returns string

      连接后的文本

      const sentence = bitbybit.text.concat({ texts: ["hello", " ", "world"] });

    vector

    • 用简单的笔画字体将一个字符绘制为线条路径。

      路径平放在 XZ 平面上，缩放到字符高为 height，并连同字符的宽度和高度一起返回。未知字符绘制为问号。 示例：'A'，高度 10 -> 一个 A 的笔画，高 10 个单位

      Parameters

      Returns VectorCharData

      字符的宽度、高度以及以点列表表示的笔画路径

      const letter = bitbybit.text.vectorChar({ char: "A", height: 10, xOffset: 0, yOffset: 0, extrudeOffset: 0 });

    • 用简单的笔画字体将带换行的文本绘制为线条路径。

      每一行以其字符及其路径返回，按给定的高度、间距和对齐方式平放在 XZ 平面上；centerOnOrigin 将文本块的中心放在原点。 示例：'Hello'，高度 10 -> 五个字符及其笔画

      Parameters

      Returns VectorTextData[]

      每行一个条目，各含其字符及其笔画路径

      const lines = bitbybit.text.vectorText({
          text: "Hello\nWorld",
          height: 10,
          align: Bit.Inputs.Base.horizontalAlignEnum.center,
          centerOnOrigin: true,
      });

    Settings

    Member Visibility

    On This Page

    Constructors
    create
    query
    regex
    transform
    vector