Klasse TextBitByBit

Arbeiten mit Text: Teilen, Verbinden, Suchen, Beschneiden, Auffüllen, Groß-/Kleinschreibung ändern, reguläre Ausdrücke und Formatieren mit Platzhaltern. vectorChar und vectorText verwandeln Text in Linienpfade, die mit einer einfachen Strichschrift gezeichnet werden, sodass Wörter zu Geometrie werden können. Positionen im Text zählen ab 0.

Index

Konstruktoren

constructor

create

Konstruktoren

constructor

new TextBitByBit(point: Bit.Point): TextBitByBit
Parameter
- point: Bit.Point
Rückgabewert TextBitByBit
- Definiert in bitbybit-docs.d.ts:56537

create

create(inputs: Bit.Inputs.Text.TextDto): string
Reicht einen Text unverändert durch, sodass ein Wert einen Namen erhalten und wiederverwendet werden kann.

Beispiel: 'Hello World' -> 'Hello World'
Parameter
- inputs: Bit.Inputs.Text.TextDto
  Der Text
Rückgabewert string
Derselbe Text
- Definiert in bitbybit-docs.d.ts:56548

query

includes

includes(inputs: TextSearchDto): boolean
Sagt, ob ein Text einen Suchtext enthält.

Beispiel: 'hello world' enthält 'world' -> true
Parameter
- inputs: TextSearchDto
  Der Text und wonach gesucht wird
Rückgabewert boolean
True, wenn der Suchtext darin vorkommt
Example
```
const has = bitbybit.text.includes({ text: "hello world", search: "world" });
```
- Definiert in bitbybit-docs.d.ts:56647

startsWith

startsWith(inputs: TextSearchDto): boolean
Sagt, ob ein Text mit einem Suchtext beginnt.

Beispiel: 'hello world' beginnt mit 'hello' -> true
Parameter
- inputs: TextSearchDto
  Der Text und wonach an seinem Anfang gesucht wird
Rückgabewert boolean
True, wenn der Text damit beginnt
Example
```
const starts = bitbybit.text.startsWith({ text: "hello world", search: "hello" });
```
- Definiert in bitbybit-docs.d.ts:56662

endsWith

endsWith(inputs: TextSearchDto): boolean
Sagt, ob ein Text mit einem Suchtext endet.

Beispiel: 'hello world' endet mit 'world' -> true
Parameter
- inputs: TextSearchDto
  Der Text und wonach an seinem Ende gesucht wird
Rückgabewert boolean
True, wenn der Text damit endet
Example
```
const ends = bitbybit.text.endsWith({ text: "hello world", search: "world" });
```
- Definiert in bitbybit-docs.d.ts:56677

indexOf

indexOf(inputs: TextSearchDto): number
Ermittelt, wo ein Suchtext zuerst vorkommt, Zeichen ab 0 gezählt, oder -1, wenn er nicht vorkommt.

Beispiel: 'hello world' Suche nach 'world' -> 6
Parameter
- inputs: TextSearchDto
  Der Text und wonach gesucht wird
Rückgabewert number
Die Position des ersten Vorkommens oder -1
Example
```
const at = bitbybit.text.indexOf({ text: "hello world", search: "world" });
```
- Definiert in bitbybit-docs.d.ts:56693

lastIndexOf

lastIndexOf(inputs: TextSearchDto): number
Ermittelt, wo ein Suchtext zuletzt vorkommt, Zeichen ab 0 gezählt, oder -1, wenn er nicht vorkommt.

Beispiel: 'hello world hello' Suche nach 'hello' -> 12
Parameter
- inputs: TextSearchDto
  Der Text und wonach gesucht wird
Rückgabewert number
Die Position des letzten Vorkommens oder -1
Example
```
const at = bitbybit.text.lastIndexOf({ text: "hello world hello", search: "hello" });
```
- Definiert in bitbybit-docs.d.ts:56709

charAt

charAt(inputs: TextIndexDto): string
Liest das Zeichen an einer Position, gezählt ab 0.

Beispiel: 'hello' bei 1 -> 'e'
Parameter
- inputs: TextIndexDto
  Der Text und die Position
Rückgabewert string
Das Zeichen oder ein leerer Text, wenn die Position außerhalb des Textes liegt
Example
```
const second = bitbybit.text.charAt({ text: "hello", index: 1 });
```
- Definiert in bitbybit-docs.d.ts:56756

length

length(inputs: Bit.Inputs.Text.TextDto): number
Zählt die Zeichen in einem Text.

Beispiel: 'hello' -> 5
Parameter
- inputs: Bit.Inputs.Text.TextDto
  Der Text
Rückgabewert number
Die Anzahl der Zeichen
- Definiert in bitbybit-docs.d.ts:56902

isEmpty

isEmpty(inputs: Bit.Inputs.Text.TextDto): boolean
Sagt, ob ein Text leer ist oder nur Leerraum enthält.

Beispiel: ' ' -> true, 'a' -> false
Parameter
- inputs: Bit.Inputs.Text.TextDto
  Der Text
Rückgabewert boolean
True, wenn nichts außer Leerraum vorhanden ist
- Definiert in bitbybit-docs.d.ts:56913

regex

regexTest

regexTest(inputs: TextRegexDto): boolean
Sagt, ob ein regulärer Ausdruck irgendwo in einem Text passt.

Beispiel: 'hello123' gegen '[0-9]+' -> true
Parameter
- inputs: TextRegexDto
  Der Text, das Muster und die Flags
Rückgabewert boolean
True, wenn das Muster passt
Example
```
const hasDigits = bitbybit.text.regexTest({ text: "hello123", pattern: "[0-9]+", flags: "" });
```
- Definiert in bitbybit-docs.d.ts:56943

regexMatch

regexMatch(inputs: TextRegexDto): string[]
Ermittelt die Teile eines Textes, auf die ein regulärer Ausdruck passt.

Mit dem Flag g wird jeder Treffer aufgelistet; ohne es nur der erste Treffer und seine Erfassungs- gruppen. Kein Treffer ergibt null. Beispiel: 'hello123world456' gegen '[0-9]+' mit 'g' -> ['123', '456']
Parameter
- inputs: TextRegexDto
  Der Text, das Muster und die Flags
Rückgabewert string[]
Die Treffer oder null, wenn es keine gibt
Example
```
const numbers = bitbybit.text.regexMatch({ text: "hello123world456", pattern: "[0-9]+", flags: "g" });
```
- Definiert in bitbybit-docs.d.ts:56960

regexReplace

regexReplace(inputs: TextRegexReplaceDto): string
Ersetzt, worauf ein regulärer Ausdruck passt, durch einen anderen Text.

Mit dem Flag g wird jeder Treffer ersetzt; ohne es nur der erste. Beispiel: 'hello123world456' gegen '[0-9]+' mit 'g', ersetzt durch 'X' -> 'helloXworldX'
Parameter
- inputs: TextRegexReplaceDto
  Der Text, das Muster, die Flags und der Ersatz
Rückgabewert string
Der Text mit den vorgenommenen Ersetzungen
Example
```
const clean = bitbybit.text.regexReplace({ text: "hello123world456", pattern: "[0-9]+", flags: "g", replaceWith: "X" });
```
- Definiert in bitbybit-docs.d.ts:56976

regexSearch

regexSearch(inputs: TextRegexDto): number
Ermittelt, wo ein regulärer Ausdruck zuerst passt, Zeichen ab 0 gezählt, oder -1, wenn er nicht passt.

Beispiel: 'hello123' gegen '[0-9]+' -> 5
Parameter
- inputs: TextRegexDto
  Der Text, das Muster und die Flags
Rückgabewert number
Die Position des ersten Treffers oder -1
Example
```
const at = bitbybit.text.regexSearch({ text: "hello123", pattern: "[0-9]+", flags: "" });
```
- Definiert in bitbybit-docs.d.ts:56992

regexSplit

regexSplit(inputs: TextRegexDto): string[]
Zerlegt einen Text überall dort in Stücke, wo ein regulärer Ausdruck passt; die Treffer selbst werden verworfen.

Beispiel: 'a1b2c3' getrennt durch '[0-9]+' -> ['a', 'b', 'c', '']
Parameter
- inputs: TextRegexDto
  Der Text, das Muster und die Flags
Rückgabewert string[]
Die Teile, in Reihenfolge
Example
```
const letters = bitbybit.text.regexSplit({ text: "a1b2c3", pattern: "[0-9]+", flags: "" });
```
- Definiert in bitbybit-docs.d.ts:57008

transform

split

split(inputs: TextSplitDto): string[]
Zerlegt einen Text überall dort in Stücke, wo ein Trennzeichen vorkommt; das Trennzeichen selbst wird verworfen.

Beispiel: 'apple,banana,cherry' getrennt durch ',' -> ['apple', 'banana', 'cherry']
Parameter
- inputs: TextSplitDto
  Der Text und das Trennzeichen
Rückgabewert string[]
Die Teile, in Reihenfolge
Example
```
const parts = bitbybit.text.split({ text: "apple,banana,cherry", separator: "," });
```
- Definiert in bitbybit-docs.d.ts:56563

replaceAll

replaceAll(inputs: TextReplaceDto): string
Ersetzt jedes Vorkommen eines Suchtextes durch einen anderen Text.

Beispiel: 'hello hello' mit 'hello' ersetzt durch 'hi' -> 'hi hi'
Parameter
- inputs: TextReplaceDto
  Der Text, wonach gesucht wird und was an seine Stelle gesetzt wird
Rückgabewert string
Der Text mit den vorgenommenen Ersetzungen
Example
```
const greeting = bitbybit.text.replaceAll({ text: "hello hello", search: "hello", replaceWith: "hi" });
```
- Definiert in bitbybit-docs.d.ts:56578

join

join(inputs: TextJoinDto): string
Verbindet eine Liste von Texten zu einem, mit einem Trennzeichen zwischen Nachbarn.

Beispiel: ['apple', 'banana', 'cherry'] verbunden durch ', ' -> 'apple, banana, cherry'
Parameter
- inputs: TextJoinDto
  Die Texte und das Trennzeichen
Rückgabewert string
Der verbundene Text
Example
```
const line = bitbybit.text.join({ list: ["apple", "banana"], separator: ", " });
```
- Definiert in bitbybit-docs.d.ts:56593

toString

toString<T>(inputs: ToStringDto<T>): string
Verwandelt einen beliebigen Wert in Text, so wie JavaScript ihn ausgibt.

Beispiel: 42 -> '42', [1, 2] -> '1,2'
Typenparameter
- T
Parameter
- inputs: ToStringDto<T>
  Der Wert
Rückgabewert string
Der Wert als Text
- Definiert in bitbybit-docs.d.ts:56604

toStringEach

toStringEach<T>(inputs: ToStringEachDto<T>): string[]
Verwandelt jedes Element einer Liste in Text, so wie JavaScript es ausgibt.

Beispiel: [1, 2.5, true] -> ['1', '2.5', 'true']
Typenparameter
- T
Parameter
- inputs: ToStringEachDto<T>
  Die Liste der Werte
Rückgabewert string[]
Ein Text pro Element, in Reihenfolge
- Definiert in bitbybit-docs.d.ts:56615

format

format(inputs: TextFormatDto): string
Füllt nummerierte Platzhalter in einem Text mit Werten: {0} nimmt den ersten Wert, {1} den zweiten, und so weiter.

Ein Platzhalter ohne Wert bleibt, wie er ist. Beispiel: 'Point: ({0}, {1})' mit [10, 5] -> 'Point: (10, 5)'
Parameter
- inputs: TextFormatDto
  Der Text mit Platzhaltern und die einzusetzenden Werte
Rückgabewert string
Der ausgefüllte Text
Example
```
const label = bitbybit.text.format({ text: "Point: ({0}, {1})", values: ["10", "5"] });
```
- Definiert in bitbybit-docs.d.ts:56632

substring

substring(inputs: TextSubstringDto): string
Nimmt die Zeichen von einer Startposition bis, aber ohne, eine Endposition.

Ein Start größer als das Ende vertauscht die beiden, und negative Positionen gelten als 0. Beispiel: 'hello world' von 0 bis 5 -> 'hello'
Parameter
- inputs: TextSubstringDto
  Der Text und die Start- und Endposition
Rückgabewert string
Die Zeichen in diesem Bereich
Example
```
const word = bitbybit.text.substring({ text: "hello world", start: 0, end: 5 });
```
- Definiert in bitbybit-docs.d.ts:56725

slice

slice(inputs: TextSubstringDto): string
Nimmt die Zeichen von einer Startposition bis, aber ohne, eine Endposition.

Anders als bei substring zählt eine negative Position vom Ende des Textes. Beispiel: 'hello world' von 0 bis 5 -> 'hello'; von -5 -> 'world'
Parameter
- inputs: TextSubstringDto
  Der Text und die Start- und Endposition
Rückgabewert string
Die Zeichen in diesem Bereich
Example
```
const tail = bitbybit.text.slice({ text: "hello world", start: 6, end: 11 });
```
- Definiert in bitbybit-docs.d.ts:56741

trim

trim(inputs: Bit.Inputs.Text.TextDto): string
Entfernt Leerzeichen, Tabulatoren und Zeilenumbrüche von beiden Enden eines Textes.

Beispiel: ' hello ' -> 'hello'
Parameter
- inputs: Bit.Inputs.Text.TextDto
  Der Text
Rückgabewert string
Der beschnittene Text
- Definiert in bitbybit-docs.d.ts:56767

trimStart

trimStart(inputs: Bit.Inputs.Text.TextDto): string
Entfernt Leerzeichen, Tabulatoren und Zeilenumbrüche vom Anfang eines Textes.

Beispiel: ' hello ' -> 'hello '
Parameter
- inputs: Bit.Inputs.Text.TextDto
  Der Text
Rückgabewert string
Der Text ohne führende Leerzeichen
- Definiert in bitbybit-docs.d.ts:56778

trimEnd

trimEnd(inputs: Bit.Inputs.Text.TextDto): string
Entfernt Leerzeichen, Tabulatoren und Zeilenumbrüche vom Ende eines Textes.

Beispiel: ' hello ' -> ' hello'
Parameter
- inputs: Bit.Inputs.Text.TextDto
  Der Text
Rückgabewert string
Der Text ohne abschließende Leerzeichen
- Definiert in bitbybit-docs.d.ts:56789

padStart

padStart(inputs: TextPadDto): string
Fügt einen Fülltext vorn an, bis der Text eine Länge erreicht; ein Text, der bereits so lang ist, bleibt unverändert.

Beispiel: 'x' auf Länge 3 mit 'a' -> 'aax'
Parameter
- inputs: TextPadDto
  Der Text, die zu erreichende Länge und das Füllzeichen
Rückgabewert string
Der aufgefüllte Text
Example
```
const padded = bitbybit.text.padStart({ text: "7", length: 3, padString: "0" });
```
- Definiert in bitbybit-docs.d.ts:56805

padEnd

padEnd(inputs: TextPadDto): string
Fügt einen Fülltext hinten an, bis der Text eine Länge erreicht; ein Text, der bereits so lang ist, bleibt unverändert.

Beispiel: 'x' auf Länge 3 mit 'a' -> 'xaa'
Parameter
- inputs: TextPadDto
  Der Text, die zu erreichende Länge und das Füllzeichen
Rückgabewert string
Der aufgefüllte Text
Example
```
const padded = bitbybit.text.padEnd({ text: "x", length: 3, padString: "a" });
```
- Definiert in bitbybit-docs.d.ts:56821

toUpperCase

toUpperCase(inputs: Bit.Inputs.Text.TextDto): string
Verwandelt jeden Buchstaben in einen Großbuchstaben.

Beispiel: 'hello' -> 'HELLO'
Parameter
- inputs: Bit.Inputs.Text.TextDto
  Der Text
Rückgabewert string
Der Text in Großbuchstaben
- Definiert in bitbybit-docs.d.ts:56832

toLowerCase

toLowerCase(inputs: Bit.Inputs.Text.TextDto): string
Verwandelt jeden Buchstaben in einen Kleinbuchstaben.

Beispiel: 'HELLO' -> 'hello'
Parameter
- inputs: Bit.Inputs.Text.TextDto
  Der Text
Rückgabewert string
Der Text in Kleinbuchstaben
- Definiert in bitbybit-docs.d.ts:56843

toUpperCaseFirst

toUpperCaseFirst(inputs: Bit.Inputs.Text.TextDto): string
Verwandelt das erste Zeichen in einen Großbuchstaben und lässt den Rest, wie er ist.

Beispiel: 'hello world' -> 'Hello world'
Parameter
- inputs: Bit.Inputs.Text.TextDto
  Der Text
Rückgabewert string
Der Text mit großgeschriebenem ersten Zeichen
- Definiert in bitbybit-docs.d.ts:56854

toLowerCaseFirst

toLowerCaseFirst(inputs: Bit.Inputs.Text.TextDto): string
Verwandelt das erste Zeichen in einen Kleinbuchstaben und lässt den Rest, wie er ist.

Beispiel: 'Hello World' -> 'hello World'
Parameter
- inputs: Bit.Inputs.Text.TextDto
  Der Text
Rückgabewert string
Der Text mit kleingeschriebenem ersten Zeichen
- Definiert in bitbybit-docs.d.ts:56865

repeat

repeat(inputs: TextRepeatDto): string
Wiederholt einen Text mehrmals, Ende an Ende.

Beispiel: 'ha' dreimal -> 'hahaha'
Parameter
- inputs: TextRepeatDto
  Der Text und wie oft er wiederholt wird
Rückgabewert string
Der wiederholte Text
Example
```
const laugh = bitbybit.text.repeat({ text: "ha", count: 3 });
```
- Definiert in bitbybit-docs.d.ts:56880

reverse

reverse(inputs: Bit.Inputs.Text.TextDto): string
Kehrt die Reihenfolge der Zeichen um.

Beispiel: 'hello' -> 'olleh'
Parameter
- inputs: Bit.Inputs.Text.TextDto
  Der Text
Rückgabewert string
Der umgekehrte Text
- Definiert in bitbybit-docs.d.ts:56891

concat

concat(inputs: TextConcatDto): string
Verbindet mehrere Texte zu einem, ohne etwas dazwischen.

Beispiel: ['hello', ' ', 'world'] -> 'hello world'
Parameter
- inputs: TextConcatDto
  Die zu verbindenden Texte
Rückgabewert string
Der verbundene Text
Example
```
const sentence = bitbybit.text.concat({ texts: ["hello", " ", "world"] });
```
- Definiert in bitbybit-docs.d.ts:56928

vector

vectorChar

vectorChar(inputs: VectorCharDto): VectorCharData
Zeichnet ein Zeichen als Linienpfade mit einer einfachen Strichschrift.

Die Pfade liegen flach auf der XZ-Ebene, so skaliert, dass das Zeichen height hoch ist, und werden mit der Breite und Höhe des Zeichens zurückgegeben. Ein unbekanntes Zeichen wird als Fragezeichen gezeichnet. Beispiel: 'A' bei Höhe 10 -> die Striche eines A, 10 Einheiten hoch
Parameter
- inputs: VectorCharDto
  Das Zeichen, seine Höhe und seine Versätze
Rückgabewert VectorCharData
Breite, Höhe und Strichpfade des Zeichens als Punktlisten
Example
```
const letter = bitbybit.text.vectorChar({ char: "A", height: 10, xOffset: 0, yOffset: 0, extrudeOffset: 0 });
```
- Definiert in bitbybit-docs.d.ts:57026

vectorText

vectorText(inputs: VectorTextDto): VectorTextData[]
Zeichnet einen Text, mit Zeilenumbrüchen, als Linienpfade mit einer einfachen Strichschrift.

Jede Zeile kommt als ihre Zeichen mit ihren Pfaden zurück, flach auf der XZ-Ebene ausgelegt mit der gegebenen Höhe, dem Abstand und der Ausrichtung; centerOnOrigin setzt die Mitte des Blocks an den Ursprung. Beispiel: 'Hello' bei Höhe 10 -> fünf Zeichen mit ihren Strichen
Parameter
- inputs: VectorTextDto
  Der Text und wie er angeordnet wird
Rückgabewert VectorTextData[]
Ein Eintrag pro Zeile, jeder mit seinen Zeichen und deren Strichpfaden
Example
```
const lines = bitbybit.text.vectorText({
    text: "Hello\nWorld",
    height: 10,
    align: Bit.Inputs.Base.horizontalAlignEnum.center,
    centerOnOrigin: true,
});
```
- Definiert in bitbybit-docs.d.ts:57049

Klasse TextBitByBit

Index

Konstruktoren

create

query

regex

transform

vector

Konstruktoren

constructor

Parameter

Rückgabewert TextBitByBit

create

create

Parameter

Rückgabewert string

query

includes

Parameter

Rückgabewert boolean

Example

startsWith

Parameter

Rückgabewert boolean

Example

endsWith

Parameter

Rückgabewert boolean

Example

indexOf

Parameter

Rückgabewert number

Example

lastIndexOf

Parameter

Rückgabewert number

Example

charAt

Parameter

Rückgabewert string

Example

length

Parameter

Rückgabewert number

isEmpty

Parameter

Rückgabewert boolean

regex

regexTest

Parameter

Rückgabewert boolean

Example

regexMatch

Parameter

Rückgabewert string[]

Example

regexReplace

Parameter

Rückgabewert string

Example

regexSearch

Parameter

Rückgabewert number

Example

regexSplit

Parameter

Rückgabewert string[]

Example

transform

split

Parameter

Rückgabewert string[]

Example

replaceAll

Parameter

Rückgabewert string

Example

join

Parameter

Rückgabewert string