Bitbybit Docs
    Preparing search index...

    Class TextBitByBit

    Bekerja dengan teks: memisah, menggabungkan, mencari, memangkas, mengisi, mengubah huruf besar-kecil, ekspresi reguler dan pemformatan dengan placeholder. vectorChar dan vectorText mengubah teks menjadi jalur garis yang digambar dengan font goresan sederhana, sehingga kata dapat menjadi geometri. Posisi dalam teks dihitung dari 0.

    Index

    Constructors

    create

    • Meneruskan teks tanpa perubahan, sehingga sebuah nilai dapat diberi nama dan dipakai ulang.

      Contoh: 'Hello World' -> 'Hello World'

      Parameters

      Returns string

      Teks yang sama

    query

    • Memberi tahu apakah sebuah teks memuat teks yang dicari.

      Contoh: 'hello world' memuat 'world' -> true

      Parameters

      Returns boolean

      True jika teks pencarian muncul di dalamnya

      const has = bitbybit.text.includes({ text: "hello world", search: "world" });
      
    • Memberi tahu apakah sebuah teks dimulai dengan teks yang dicari.

      Contoh: 'hello world' dimulai dengan 'hello' -> true

      Parameters

      Returns boolean

      True jika teks dimulai dengannya

      const starts = bitbybit.text.startsWith({ text: "hello world", search: "hello" });
      
    • Memberi tahu apakah sebuah teks diakhiri dengan teks yang dicari.

      Contoh: 'hello world' diakhiri dengan 'world' -> true

      Parameters

      Returns boolean

      True jika teks diakhiri dengannya

      const ends = bitbybit.text.endsWith({ text: "hello world", search: "world" });
      
    • Menemukan tempat teks yang dicari pertama kali muncul, menghitung karakter dari 0, atau -1 jika tidak muncul.

      Contoh: 'hello world' mencari 'world' -> 6

      Parameters

      Returns number

      Posisi kemunculan pertama, atau -1

      const at = bitbybit.text.indexOf({ text: "hello world", search: "world" });
      
    • Menemukan tempat teks yang dicari terakhir kali muncul, menghitung karakter dari 0, atau -1 jika tidak muncul.

      Contoh: 'hello world hello' mencari 'hello' -> 12

      Parameters

      Returns number

      Posisi kemunculan terakhir, atau -1

      const at = bitbybit.text.lastIndexOf({ text: "hello world hello", search: "hello" });
      
    • Membaca karakter pada suatu posisi, dihitung dari 0.

      Contoh: 'hello' pada 1 -> 'e'

      Parameters

      Returns string

      Karakter, atau teks kosong jika posisinya di luar teks

      const second = bitbybit.text.charAt({ text: "hello", index: 1 });
      
    • Menghitung karakter dalam teks.

      Contoh: 'hello' -> 5

      Parameters

      Returns number

      Jumlah karakter

    • Memberi tahu apakah sebuah teks kosong atau hanya berisi spasi.

      Contoh: ' ' -> true, 'a' -> false

      Parameters

      Returns boolean

      True jika tidak ada apa pun selain spasi

    regex

    • Memberi tahu apakah ekspresi reguler cocok di suatu tempat dalam teks.

      Contoh: 'hello123' terhadap '[0-9]+' -> true

      Parameters

      Returns boolean

      True jika pola cocok

      const hasDigits = bitbybit.text.regexTest({ text: "hello123", pattern: "[0-9]+", flags: "" });
      
    • Menemukan bagian-bagian teks yang cocok dengan ekspresi reguler.

      Dengan flag g setiap kecocokan dicantumkan; tanpanya hanya kecocokan pertama dan grup tangkapannya. Tidak ada kecocokan menghasilkan null. Contoh: 'hello123world456' terhadap '[0-9]+' dengan 'g' -> ['123', '456']

      Parameters

      Returns string[]

      Kecocokan-kecocokannya, atau null jika tidak ada

      const numbers = bitbybit.text.regexMatch({ text: "hello123world456", pattern: "[0-9]+", flags: "g" });
      
    • Mengganti apa yang cocok dengan ekspresi reguler dengan teks lain.

      Dengan flag g setiap kecocokan diganti; tanpanya hanya yang pertama. Contoh: 'hello123world456' terhadap '[0-9]+' dengan 'g', diganti dengan 'X' -> 'helloXworldX'

      Parameters

      Returns string

      Teks dengan penggantian yang telah dilakukan

      const clean = bitbybit.text.regexReplace({ text: "hello123world456", pattern: "[0-9]+", flags: "g", replaceWith: "X" });
      
    • Menemukan tempat ekspresi reguler pertama kali cocok, menghitung karakter dari 0, atau -1 jika tidak cocok.

      Contoh: 'hello123' terhadap '[0-9]+' -> 5

      Parameters

      Returns number

      Posisi kecocokan pertama, atau -1

      const at = bitbybit.text.regexSearch({ text: "hello123", pattern: "[0-9]+", flags: "" });
      
    • Memotong teks menjadi beberapa bagian di mana pun ekspresi reguler cocok; kecocokannya sendiri dibuang.

      Contoh: 'a1b2c3' dipisah dengan '[0-9]+' -> ['a', 'b', 'c', '']

      Parameters

      Returns string[]

      Potongan-potongannya, secara berurutan

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

    transform

    • Memotong teks menjadi beberapa bagian di mana pun pemisah muncul; pemisahnya sendiri dibuang.

      Contoh: 'apple,banana,cherry' dipisah dengan ',' -> ['apple', 'banana', 'cherry']

      Parameters

      Returns string[]

      Potongan-potongannya, secara berurutan

      const parts = bitbybit.text.split({ text: "apple,banana,cherry", separator: "," });
      
    • Mengganti setiap kemunculan teks yang dicari dengan teks lain.

      Contoh: 'hello hello' mengganti 'hello' dengan 'hi' -> 'hi hi'

      Parameters

      Returns string

      Teks dengan penggantian yang telah dilakukan

      const greeting = bitbybit.text.replaceAll({ text: "hello hello", search: "hello", replaceWith: "hi" });
      
    • Menyambung daftar teks menjadi satu, dengan pemisah di antara tetangga.

      Contoh: ['apple', 'banana', 'cherry'] disambung dengan ', ' -> 'apple, banana, cherry'

      Parameters

      Returns string

      Teks hasil penggabungan

      const line = bitbybit.text.join({ list: ["apple", "banana"], separator: ", " });
      
    • Mengubah nilai apa pun menjadi teks, sebagaimana JavaScript mencetaknya.

      Contoh: 42 -> '42', [1, 2] -> '1,2'

      Type Parameters

      • T

      Parameters

      Returns string

      Nilai sebagai teks

    • Mengubah setiap item daftar menjadi teks, sebagaimana JavaScript mencetaknya.

      Contoh: [1, 2.5, true] -> ['1', '2.5', 'true']

      Type Parameters

      • T

      Parameters

      Returns string[]

      Satu teks per item, secara berurutan

    • Mengisi placeholder bernomor dalam teks dengan nilai-nilai: {0} mengambil nilai pertama, {1} yang kedua, dan seterusnya.

      Placeholder tanpa nilai dibiarkan apa adanya. Contoh: 'Point: ({0}, {1})' dengan [10, 5] -> 'Point: (10, 5)'

      Parameters

      • inputs: TextFormatDto

        Teks dengan placeholder dan nilai-nilai pengisinya

      Returns string

      Teks yang telah diisi

      const label = bitbybit.text.format({ text: "Point: ({0}, {1})", values: ["10", "5"] });
      
    • Mengambil karakter dari posisi awal sampai, tetapi tidak termasuk, posisi akhir.

      Awal yang lebih besar dari akhir menukar keduanya, dan posisi negatif dihitung sebagai 0. Contoh: 'hello world' dari 0 sampai 5 -> 'hello'

      Parameters

      Returns string

      Karakter-karakter dalam rentang tersebut

      const word = bitbybit.text.substring({ text: "hello world", start: 0, end: 5 });
      
    • Mengambil karakter dari posisi awal sampai, tetapi tidak termasuk, posisi akhir.

      Berbeda dengan substring, posisi negatif dihitung dari akhir teks. Contoh: 'hello world' dari 0 sampai 5 -> 'hello'; dari -5 -> 'world'

      Parameters

      Returns string

      Karakter-karakter dalam rentang tersebut

      const tail = bitbybit.text.slice({ text: "hello world", start: 6, end: 11 });
      
    • Menghapus spasi, tab dan pemisah baris dari kedua ujung teks.

      Contoh: ' hello ' -> 'hello'

      Parameters

      Returns string

      Teks yang dipangkas

    • Menghapus spasi, tab dan pemisah baris dari awal teks.

      Contoh: ' hello ' -> 'hello '

      Parameters

      Returns string

      Teks tanpa spasi di awal

    • Menghapus spasi, tab dan pemisah baris dari akhir teks.

      Contoh: ' hello ' -> ' hello'

      Parameters

      Returns string

      Teks tanpa spasi di akhir

    • Menambahkan teks pengisi di depan sampai teks mencapai suatu panjang; teks yang sudah sepanjang itu dibiarkan.

      Contoh: 'x' sampai panjang 3 dengan 'a' -> 'aax'

      Parameters

      • inputs: TextPadDto

        Teks, panjang yang dicapai dan pengisinya

      Returns string

      Teks yang diberi pengisi

      const padded = bitbybit.text.padStart({ text: "7", length: 3, padString: "0" });
      
    • Menambahkan teks pengisi di belakang sampai teks mencapai suatu panjang; teks yang sudah sepanjang itu dibiarkan.

      Contoh: 'x' sampai panjang 3 dengan 'a' -> 'xaa'

      Parameters

      • inputs: TextPadDto

        Teks, panjang yang dicapai dan pengisinya

      Returns string

      Teks yang diberi pengisi

      const padded = bitbybit.text.padEnd({ text: "x", length: 3, padString: "a" });
      
    • Mengubah setiap huruf menjadi kapital.

      Contoh: 'hello' -> 'HELLO'

      Parameters

      Returns string

      Teks dalam huruf kapital

    • Mengubah setiap huruf menjadi huruf kecil.

      Contoh: 'HELLO' -> 'hello'

      Parameters

      Returns string

      Teks dalam huruf kecil

    • Mengubah karakter pertama menjadi kapital dan membiarkan sisanya apa adanya.

      Contoh: 'hello world' -> 'Hello world'

      Parameters

      Returns string

      Teks dengan karakter pertamanya dikapitalkan

    • Mengubah karakter pertama menjadi huruf kecil dan membiarkan sisanya apa adanya.

      Contoh: 'Hello World' -> 'hello World'

      Parameters

      Returns string

      Teks dengan karakter pertamanya dalam huruf kecil

    • Mengulang teks sejumlah kali, ujung ke ujung.

      Contoh: 'ha' tiga kali -> 'hahaha'

      Parameters

      Returns string

      Teks yang diulang

      const laugh = bitbybit.text.repeat({ text: "ha", count: 3 });
      
    • Membalik urutan karakter-karakter.

      Contoh: 'hello' -> 'olleh'

      Parameters

      Returns string

      Teks yang dibalik

    • Menyambung beberapa teks menjadi satu tanpa apa pun di antaranya.

      Contoh: ['hello', ' ', 'world'] -> 'hello world'

      Parameters

      Returns string

      Teks hasil penggabungan

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

    vector

    • Menggambar satu karakter sebagai path garis dengan font goresan sederhana.

      Path-path terbaring rata pada bidang XZ, diskalakan sehingga karakter setinggi height, dan dikembalikan beserta lebar dan tinggi karakter. Karakter yang tidak dikenal digambar sebagai tanda tanya. Contoh: 'A' pada tinggi 10 -> goresan-goresan huruf A, setinggi 10 satuan

      Parameters

      Returns VectorCharData

      Lebar, tinggi dan jalur goresan karakter sebagai daftar titik

      const letter = bitbybit.text.vectorChar({ char: "A", height: 10, xOffset: 0, yOffset: 0, extrudeOffset: 0 });
      
    • Menggambar teks, dengan pemisah baris, sebagai path garis dengan font goresan sederhana.

      Setiap baris dikembalikan sebagai karakter-karakternya beserta path-nya, disusun rata pada bidang XZ dengan tinggi, jarak dan penjajaran yang diberikan; centerOnOrigin menempatkan tengah blok di titik asal. Contoh: 'Hello' pada tinggi 10 -> lima karakter beserta goresannya

      Parameters

      Returns VectorTextData[]

      Satu entri per baris, masing-masing dengan karakter dan jalur goresannya

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