Kelas System.Text.StringBuilder
Artikel ini menyediakan keterangan tambahan untuk dokumentasi referensi untuk API ini.
Kelas StringBuilder mewakili objek seperti string yang nilainya adalah urutan karakter yang dapat diubah.
StringBuilder versus jenis String
Meskipun StringBuilder dan String keduanya mewakili urutan karakter, keduanya diimplementasikan secara berbeda. String adalah jenis yang tidak dapat diubah. Artinya, setiap operasi yang tampaknya memodifikasi String objek benar-benar membuat string baru.
Misalnya, panggilan ke String.Concat metode dalam contoh C# berikut tampaknya mengubah nilai variabel string bernama value. Bahkan, metode mengembalikan Concatvalue objek yang memiliki nilai dan alamat yang berbeda dari value objek yang diteruskan ke metode . Perhatikan bahwa contoh harus dikompilasi menggunakan /unsafe opsi pengkompilasi.
using System;
public class Example7
{
public unsafe static void Main()
{
string value = "This is the first sentence" + ".";
fixed (char* start = value)
{
value = String.Concat(value, "This is the second sentence. ");
fixed (char* current = value)
{
Console.WriteLine(start == current);
}
}
}
}
// The example displays the following output:
// False
let mutable value = "This is the first sentence" + "."
use start = fixed value
value <- System.String.Concat(value, "This is the second sentence. ")
use current = fixed value
printfn $"{start = current}"
// The example displays the following output:
// False
Untuk rutinitas yang melakukan manipulasi string ekstensif (seperti aplikasi yang memodifikasi string berkali-kali dalam perulangan), memodifikasi string berulang kali dapat menentukan penalti performa yang signifikan. Alternatifnya adalah menggunakan StringBuilder, yang merupakan kelas string yang dapat diubah. Mutabilitas berarti bahwa setelah instans kelas dibuat, instans dapat dimodifikasi dengan menambahkan, menghapus, mengganti, atau menyisipkan karakter. Objek StringBuilder mempertahankan buffer untuk mengakomodasi ekspansi ke string. Data baru ditambahkan ke buffer jika ruang tersedia; jika tidak, buffer baru yang lebih besar dialokasikan, data dari buffer asli disalin ke buffer baru, dan data baru kemudian ditambahkan ke buffer baru.
Penting
StringBuilder Meskipun kelas umumnya menawarkan performa yang String lebih baik daripada kelas , Anda tidak boleh secara otomatis mengganti String dengan StringBuilder kapan pun Anda ingin memanipulasi string. Performa tergantung pada ukuran string, jumlah memori yang akan dialokasikan untuk string baru, sistem tempat kode Anda dijalankan, dan jenis operasi. Anda harus siap untuk menguji kode Anda untuk menentukan apakah StringBuilder benar-benar menawarkan peningkatan performa yang signifikan.
Pertimbangkan untuk menggunakan kelas dalam String kondisi berikut:
Ketika jumlah perubahan yang akan dibuat kode Anda ke string kecil. Dalam kasus ini, StringBuilder mungkin menawarkan peningkatan performa yang dapat diabaikan atau tidak ada peningkatan performa atas String.
Ketika Anda melakukan sejumlah operasi penggalian tetap, terutama dengan literal string. Dalam hal ini, pengompilasi mungkin menggabungkan operasi penggabungan ke dalam satu operasi.
Ketika Anda harus melakukan operasi pencarian yang luas saat Anda membangun string Anda. Kelas StringBuilder tidak memiliki metode pencarian seperti
IndexOfatauStartsWith. Anda harus mengonversi StringBuilder objek ke String untuk operasi ini, dan ini dapat meniadakan manfaat performa dari menggunakan StringBuilder. Untuk informasi selengkapnya, lihat bagian Cari teks di objek StringBuilder.
Pertimbangkan untuk menggunakan kelas dalam StringBuilder kondisi berikut:
- Ketika Anda mengharapkan kode Anda untuk membuat sejumlah perubahan yang tidak diketahui pada string pada waktu desain (misalnya, saat Anda menggunakan perulangan untuk menggabungkan jumlah string acak yang berisi input pengguna).
- Ketika Anda mengharapkan kode Anda untuk membuat sejumlah besar perubahan pada string.
Cara kerja StringBuilder
Properti StringBuilder.Length menunjukkan jumlah karakter yang saat ini dikandung StringBuilder objek. Jika Anda menambahkan karakter ke StringBuilder objek, panjangnya meningkat hingga sama dengan ukuran StringBuilder.Capacity properti, yang menentukan jumlah karakter yang dapat dimuat objek. Jika jumlah karakter yang ditambahkan menyebabkan panjang StringBuilder objek melebihi kapasitasnya saat ini, memori baru dialokasikan, nilai Capacity properti digandakan, karakter baru ditambahkan ke StringBuilder objek, dan propertinya Length disesuaikan. Memori tambahan untuk StringBuilder objek dialokasikan secara dinamis sampai mencapai nilai yang ditentukan oleh StringBuilder.MaxCapacity properti . Ketika kapasitas maksimum tercapai, tidak ada memori lebih lanjut yang dapat dialokasikan untuk StringBuilder objek, dan mencoba menambahkan karakter atau memperluasnya di luar kapasitas maksimumnya melemparkan ArgumentOutOfRangeException pengecualian atau OutOfMemoryException .
Contoh berikut menggambarkan bagaimana StringBuilder objek mengalokasikan memori baru dan meningkatkan kapasitasnya secara dinamis saat string yang ditetapkan ke objek diperluas. Kode membuat StringBuilder objek dengan memanggil konstruktor defaultnya (tanpa parameter). Kapasitas default objek ini adalah 16 karakter, dan kapasitas maksimumnya lebih dari 2 miliar karakter. Menambahkan string "Ini adalah kalimat." menghasilkan alokasi memori baru karena panjang string (19 karakter) melebihi kapasitas StringBuilder default objek. Kapasitas objek dua kali lipat menjadi 32 karakter, string baru ditambahkan, dan panjang objek sekarang sama dengan 19 karakter. Kode kemudian menambahkan string "Ini adalah kalimat tambahan." ke nilai StringBuilder objek 11 kali. Setiap kali operasi penambalan menyebabkan panjang StringBuilder objek melebihi kapasitasnya, kapasitas yang ada digandakan dan Append operasi berhasil.
using System;
using System.Reflection;
using System.Text;
public class Example4
{
public static void Main()
{
StringBuilder sb = new StringBuilder();
ShowSBInfo(sb);
sb.Append("This is a sentence.");
ShowSBInfo(sb);
for (int ctr = 0; ctr <= 10; ctr++)
{
sb.Append("This is an additional sentence.");
ShowSBInfo(sb);
}
}
private static void ShowSBInfo(StringBuilder sb)
{
foreach (var prop in sb.GetType().GetProperties())
{
if (prop.GetIndexParameters().Length == 0)
Console.Write("{0}: {1:N0} ", prop.Name, prop.GetValue(sb));
}
Console.WriteLine();
}
}
// The example displays the following output:
// Capacity: 16 MaxCapacity: 2,147,483,647 Length: 0
// Capacity: 32 MaxCapacity: 2,147,483,647 Length: 19
// Capacity: 64 MaxCapacity: 2,147,483,647 Length: 50
// Capacity: 128 MaxCapacity: 2,147,483,647 Length: 81
// Capacity: 128 MaxCapacity: 2,147,483,647 Length: 112
// Capacity: 256 MaxCapacity: 2,147,483,647 Length: 143
// Capacity: 256 MaxCapacity: 2,147,483,647 Length: 174
// Capacity: 256 MaxCapacity: 2,147,483,647 Length: 205
// Capacity: 256 MaxCapacity: 2,147,483,647 Length: 236
// Capacity: 512 MaxCapacity: 2,147,483,647 Length: 267
// Capacity: 512 MaxCapacity: 2,147,483,647 Length: 298
// Capacity: 512 MaxCapacity: 2,147,483,647 Length: 329
// Capacity: 512 MaxCapacity: 2,147,483,647 Length: 360
open System.Text
let showSBInfo (sb: StringBuilder) =
for prop in sb.GetType().GetProperties() do
if prop.GetIndexParameters().Length = 0 then
printf $"{prop.Name}: {prop.GetValue sb:N0} "
printfn ""
let sb = StringBuilder()
showSBInfo sb
sb.Append "This is a sentence." |> ignore
showSBInfo sb
for i = 0 to 10 do
sb.Append "This is an additional sentence." |> ignore
showSBInfo sb
// The example displays the following output:
// Capacity: 16 MaxCapacity: 2,147,483,647 Length: 0
// Capacity: 32 MaxCapacity: 2,147,483,647 Length: 19
// Capacity: 64 MaxCapacity: 2,147,483,647 Length: 50
// Capacity: 128 MaxCapacity: 2,147,483,647 Length: 81
// Capacity: 128 MaxCapacity: 2,147,483,647 Length: 112
// Capacity: 256 MaxCapacity: 2,147,483,647 Length: 143
// Capacity: 256 MaxCapacity: 2,147,483,647 Length: 174
// Capacity: 256 MaxCapacity: 2,147,483,647 Length: 205
// Capacity: 256 MaxCapacity: 2,147,483,647 Length: 236
// Capacity: 512 MaxCapacity: 2,147,483,647 Length: 267
// Capacity: 512 MaxCapacity: 2,147,483,647 Length: 298
// Capacity: 512 MaxCapacity: 2,147,483,647 Length: 329
// Capacity: 512 MaxCapacity: 2,147,483,647 Length: 360
Imports System.Reflection
Imports System.Text
Module Example5
Public Sub Main()
Dim sb As New StringBuilder()
ShowSBInfo(sb)
sb.Append("This is a sentence.")
ShowSBInfo(sb)
For ctr As Integer = 0 To 10
sb.Append("This is an additional sentence.")
ShowSBInfo(sb)
Next
End Sub
Public Sub ShowSBInfo(sb As StringBuilder)
For Each prop In sb.GetType().GetProperties
If prop.GetIndexParameters().Length = 0 Then
Console.Write("{0}: {1:N0} ", prop.Name, prop.GetValue(sb))
End If
Next
Console.WriteLine()
End Sub
End Module
' The example displays the following output:
' Capacity: 16 MaxCapacity: 2,147,483,647 Length: 0
' Capacity: 32 MaxCapacity: 2,147,483,647 Length: 19
' Capacity: 64 MaxCapacity: 2,147,483,647 Length: 50
' Capacity: 128 MaxCapacity: 2,147,483,647 Length: 81
' Capacity: 128 MaxCapacity: 2,147,483,647 Length: 112
' Capacity: 256 MaxCapacity: 2,147,483,647 Length: 143
' Capacity: 256 MaxCapacity: 2,147,483,647 Length: 174
' Capacity: 256 MaxCapacity: 2,147,483,647 Length: 205
' Capacity: 256 MaxCapacity: 2,147,483,647 Length: 236
' Capacity: 512 MaxCapacity: 2,147,483,647 Length: 267
' Capacity: 512 MaxCapacity: 2,147,483,647 Length: 298
' Capacity: 512 MaxCapacity: 2,147,483,647 Length: 329
' Capacity: 512 MaxCapacity: 2,147,483,647 Length: 360
Alokasi Memori
Kapasitas StringBuilder default objek adalah 16 karakter, dan kapasitas maksimum defaultnya adalah Int32.MaxValue. Nilai default ini digunakan jika Anda memanggil StringBuilder() konstruktor dan StringBuilder(String) .
Anda dapat secara eksplisit menentukan kapasitas StringBuilder awal objek dengan cara berikut:
Dengan memanggil salah StringBuilder satu konstruktor yang menyertakan
capacityparameter saat Anda membuat objek.Dengan secara eksplisit menetapkan nilai baru ke StringBuilder.Capacity properti untuk memperluas objek yang ada StringBuilder . Perhatikan bahwa properti memberikan pengecualian jika kapasitas baru kurang dari kapasitas yang ada atau lebih besar dari StringBuilder kapasitas maksimum objek.
Dengan memanggil StringBuilder.EnsureCapacity metode dengan kapasitas baru. Kapasitas baru tidak boleh lebih besar dari StringBuilder kapasitas maksimum objek. Namun, tidak seperti penugasan ke Capacity properti, EnsureCapacity tidak memberikan pengecualian jika kapasitas baru yang diinginkan kurang dari kapasitas yang ada; dalam hal ini, panggilan metode tidak berpengaruh.
Jika panjang string yang ditetapkan ke StringBuilder objek dalam panggilan konstruktor melebihi kapasitas default atau kapasitas yang ditentukan, Capacity properti diatur ke panjang string yang ditentukan dengan value parameter .
Anda dapat secara eksplisit menentukan kapasitas StringBuilder maksimum objek dengan memanggil StringBuilder(Int32, Int32) konstruktor. Anda tidak dapat mengubah kapasitas maksimum dengan menetapkan nilai baru ke MaxCapacity properti , karena bersifat baca-saja.
Seperti yang ditunjukkan bagian sebelumnya, setiap kali kapasitas yang ada tidak memadai, memori tambahan dialokasikan dan kapasitas StringBuilder objek dua kali lipat hingga nilai yang ditentukan oleh MaxCapacity properti.
Secara umum, kapasitas default dan kapasitas maksimum memadai untuk sebagian besar aplikasi. Anda mungkin mempertimbangkan untuk mengatur nilai-nilai ini dalam kondisi berikut:
Jika ukuran StringBuilder akhirnya objek cenderung tumbuh terlalu besar, biasanya melebihi beberapa megabyte. Dalam hal ini, mungkin ada beberapa manfaat performa dari mengatur properti awal Capacity ke nilai yang sangat tinggi untuk menghilangkan kebutuhan akan terlalu banyak realokasi memori.
Jika kode Anda berjalan pada sistem dengan memori terbatas. Dalam hal ini, Anda mungkin ingin mempertimbangkan untuk mengatur MaxCapacity properti menjadi kurang dari Int32.MaxValue jika kode Anda menangani string besar yang dapat menyebabkannya dijalankan di lingkungan yang dibatasi memori.
Membuat instans objek StringBuilder
Anda membuat instans StringBuilder objek dengan memanggil salah satu dari enam konstruktor kelasnya yang kelebihan beban, yang tercantum dalam tabel berikut. Tiga konstruktor membuat instans StringBuilder objek yang nilainya adalah string kosong, tetapi mengatur nilai dannya CapacityMaxCapacity secara berbeda. Tiga konstruktor yang tersisa menentukan StringBuilder objek yang memiliki nilai dan kapasitas string tertentu. Dua dari tiga konstruktor menggunakan kapasitas Int32.MaxValuemaksimum default , sedangkan yang ketiga memungkinkan Anda untuk mengatur kapasitas maksimum.
| Konstruktor | Nilai untai (karakter) | Kapasitas | Kapasitas maksimum |
|---|---|---|---|
| StringBuilder() | String.Empty | 16 | Int32.MaxValue |
| StringBuilder(Int32) | String.Empty | Ditentukan oleh capacity parameter |
Int32.MaxValue |
| StringBuilder(Int32, Int32) | String.Empty | Ditentukan oleh capacity parameter |
Ditentukan oleh maxCapacity parameter |
| StringBuilder(String) | Ditentukan oleh value parameter |
16 atau value. Length, mana pun yang lebih besar |
Int32.MaxValue |
| StringBuilder(String, Int32) | Ditentukan oleh value parameter |
Ditentukan oleh capacity parameter atau value. Length, mana pun yang lebih besar. |
Int32.MaxValue |
| StringBuilder(String, Int32, Int32, Int32) | Ditentukan oleh value. Substring(startIndex, length) |
Ditentukan oleh capacity parameter atau value. Length, mana pun yang lebih besar. |
Int32.MaxValue |
Contoh berikut menggunakan tiga kelebihan beban konstruktor ini untuk membuat StringBuilder instans objek.
using System;
using System.Text;
public class Example8
{
public static void Main()
{
string value = "An ordinary string";
int index = value.IndexOf("An ") + 3;
int capacity = 0xFFFF;
// Instantiate a StringBuilder from a string.
StringBuilder sb1 = new StringBuilder(value);
ShowSBInfo(sb1);
// Instantiate a StringBuilder from string and define a capacity.
StringBuilder sb2 = new StringBuilder(value, capacity);
ShowSBInfo(sb2);
// Instantiate a StringBuilder from substring and define a capacity.
StringBuilder sb3 = new StringBuilder(value, index,
value.Length - index,
capacity);
ShowSBInfo(sb3);
}
public static void ShowSBInfo(StringBuilder sb)
{
Console.WriteLine("\nValue: {0}", sb.ToString());
foreach (var prop in sb.GetType().GetProperties())
{
if (prop.GetIndexParameters().Length == 0)
Console.Write("{0}: {1:N0} ", prop.Name, prop.GetValue(sb));
}
Console.WriteLine();
}
}
// The example displays the following output:
// Value: An ordinary string
// Capacity: 18 MaxCapacity: 2,147,483,647 Length: 18
//
// Value: An ordinary string
// Capacity: 65,535 MaxCapacity: 2,147,483,647 Length: 18
//
// Value: ordinary string
// Capacity: 65,535 MaxCapacity: 2,147,483,647 Length: 15
open System.Text
let showSBInfo (sb: StringBuilder) =
for prop in sb.GetType().GetProperties() do
if prop.GetIndexParameters().Length = 0 then
printf $"{prop.Name}: {prop.GetValue sb:N0} "
printfn ""
let value = "An ordinary string"
let index = value.IndexOf "An " + 3
let capacity = 0xFFFF
// Instantiate a StringBuilder from a string.
let sb1 = StringBuilder value
showSBInfo sb1
// Instantiate a StringBuilder from string and define a capacity.
let sb2 = StringBuilder(value, capacity)
showSBInfo sb2
// Instantiate a StringBuilder from substring and define a capacity.
let sb3 = StringBuilder(value, index, value.Length - index, capacity)
showSBInfo sb3
// The example displays the following output:
// Value: An ordinary string
// Capacity: 18 MaxCapacity: 2,147,483,647 Length: 18
//
// Value: An ordinary string
// Capacity: 65,535 MaxCapacity: 2,147,483,647 Length: 18
//
// Value: ordinary string
// Capacity: 65,535 MaxCapacity: 2,147,483,647 Length: 15
Imports System.Text
Module Example8
Public Sub Main()
Dim value As String = "An ordinary string"
Dim index As Integer = value.IndexOf("An ") + 3
Dim capacity As Integer = &HFFFF
' Instantiate a StringBuilder from a string.
Dim sb1 As New StringBuilder(value)
ShowSBInfo(sb1)
' Instantiate a StringBuilder from string and define a capacity.
Dim sb2 As New StringBuilder(value, capacity)
ShowSBInfo(sb2)
' Instantiate a StringBuilder from substring and define a capacity.
Dim sb3 As New StringBuilder(value, index,
value.Length - index,
capacity)
ShowSBInfo(sb3)
End Sub
Public Sub ShowSBInfo(sb As StringBuilder)
Console.WriteLine()
Console.WriteLine("Value: {0}", sb.ToString())
For Each prop In sb.GetType().GetProperties
If prop.GetIndexParameters().Length = 0 Then
Console.Write("{0}: {1:N0} ", prop.Name, prop.GetValue(sb))
End If
Next
Console.WriteLine()
End Sub
End Module
' The example displays the following output:
' Value: An ordinary string
' Capacity: 18 MaxCapacity: 2,147,483,647 Length: 18
'
' Value: An ordinary string
' Capacity: 65,535 MaxCapacity: 2,147,483,647 Length: 18
'
' Value: ordinary string
' Capacity: 65,535 MaxCapacity: 2,147,483,647 Length: 15
Memanggil metode StringBuilder
Sebagian besar metode yang memodifikasi string dalam StringBuilder instans mengembalikan referensi ke instans yang sama. Ini memungkinkan Anda untuk memanggil StringBuilder metode dengan dua cara:
Anda dapat melakukan panggilan metode individual dan mengabaikan nilai pengembalian, seperti contoh berikut.
using System; using System.Text; public class Example { public static void Main() { StringBuilder sb = new StringBuilder(); sb.Append("This is the beginning of a sentence, "); sb.Replace("the beginning of ", ""); sb.Insert(sb.ToString().IndexOf("a ") + 2, "complete "); sb.Replace(",", "."); Console.WriteLine(sb.ToString()); } } // The example displays the following output: // This is a complete sentence.open System.Text let sb = StringBuilder() sb.Append "This is the beginning of a sentence, " |> ignore sb.Replace("the beginning of ", "") |> ignore sb.Insert((string sb).IndexOf "a " + 2, "complete ") |> ignore sb.Replace(",", ".") |> ignore printfn $"{sb}" // The example displays the following output: // This is a complete sentence.Imports System.Text Module Example2 Public Sub Main() Dim sb As New StringBuilder() sb.Append("This is the beginning of a sentence, ") sb.Replace("the beginning of ", "") sb.Insert(sb.ToString().IndexOf("a ") + 2, "complete ") sb.Replace(",", ".") Console.WriteLine(sb.ToString()) End Sub End Module ' The example displays the following output: ' This is a complete sentence.Anda dapat melakukan serangkaian panggilan metode dalam satu pernyataan. Ini bisa nyaman jika Anda ingin menulis satu pernyataan yang menautkan operasi berturut-turut. Contoh berikut mengonsolidasikan tiga panggilan metode dari contoh sebelumnya ke dalam satu baris kode.
using System; using System.Text; public class Example2 { public static void Main() { StringBuilder sb = new StringBuilder("This is the beginning of a sentence, "); sb.Replace("the beginning of ", "").Insert(sb.ToString().IndexOf("a ") + 2, "complete ").Replace(",", "."); Console.WriteLine(sb.ToString()); } } // The example displays the following output: // This is a complete sentence.open System.Text let sb = StringBuilder "This is the beginning of a sentence, " sb .Replace("the beginning of ", "") .Insert((string sb).IndexOf "a " + 2, "complete ") .Replace(",", ".") |> ignore printfn $"{sb}" // The example displays the following output: // This is a complete sentence.Imports System.Text Module Example3 Public Sub Main() Dim sb As New StringBuilder("This is the beginning of a sentence, ") sb.Replace("the beginning of ", "").Insert(sb.ToString().IndexOf("a ") + 2, "complete ").Replace(", ", ".") Console.WriteLine(sb.ToString()) End Sub End Module ' The example displays the following output: ' This is a complete sentence.
Melakukan operasi StringBuilder
Anda dapat menggunakan metode StringBuilder kelas untuk melakukan iterasi, menambahkan, menghapus, atau memodifikasi karakter dalam StringBuilder objek.
Iterasi karakter StringBuilder
Anda dapat mengakses karakter dalam StringBuilder objek dengan menggunakan StringBuilder.Chars[] properti . Di C#, Chars[] adalah pengindeks; di Visual Basic, ini adalah properti default kelas StringBuilder . Ini memungkinkan Anda untuk mengatur atau mengambil karakter individual hanya dengan menggunakan indeks mereka, tanpa secara eksplisit mereferensikan Chars[] properti. Karakter dalam StringBuilder objek dimulai pada indeks 0 (nol) dan lanjutkan ke indeks Length - 1.
Contoh berikut mengilustrasikan Chars[] properti . Ini menambahkan sepuluh angka acak ke StringBuilder objek, lalu mengurai setiap karakter. Jika kategori Unicode karakter adalah UnicodeCategory.DecimalDigitNumber, itu mengurangi angka sebesar 1 (atau mengubah angka menjadi 9 jika nilainya adalah 0). Contoh menampilkan konten StringBuilder objek baik sebelum dan sesudah nilai karakter individual diubah.
using System;
using System.Globalization;
using System.Text;
public class Example3
{
public static void Main()
{
Random rnd = new Random();
StringBuilder sb = new StringBuilder();
// Generate 10 random numbers and store them in a StringBuilder.
for (int ctr = 0; ctr <= 9; ctr++)
sb.Append(rnd.Next().ToString("N5"));
Console.WriteLine("The original string:");
Console.WriteLine(sb.ToString());
// Decrease each number by one.
for (int ctr = 0; ctr < sb.Length; ctr++)
{
if (Char.GetUnicodeCategory(sb[ctr]) == UnicodeCategory.DecimalDigitNumber)
{
int number = (int)Char.GetNumericValue(sb[ctr]);
number--;
if (number < 0) number = 9;
sb[ctr] = number.ToString()[0];
}
}
Console.WriteLine("\nThe new string:");
Console.WriteLine(sb.ToString());
}
}
// The example displays the following output:
// The original string:
// 1,457,531,530.00000940,522,609.000001,668,113,564.000001,998,992,883.000001,792,660,834.00
// 000101,203,251.000002,051,183,075.000002,066,000,067.000001,643,701,043.000001,702,382,508
// .00000
//
// The new string:
// 0,346,420,429.99999839,411,598.999990,557,002,453.999990,887,881,772.999990,681,559,723.99
// 999090,192,140.999991,940,072,964.999991,955,999,956.999990,532,690,932.999990,691,271,497
// .99999
open System
open System.Globalization
open System.Text
let rnd = Random()
let sb = new StringBuilder()
// Generate 10 random numbers and store them in a StringBuilder.
for _ = 0 to 9 do
rnd.Next().ToString "N5" |> sb.Append |> ignore
printfn "The original string:"
printfn $"{sb}"
// Decrease each number by one.
for i = 0 to sb.Length - 1 do
if Char.GetUnicodeCategory(sb[i]) = UnicodeCategory.DecimalDigitNumber then
let number = Char.GetNumericValue sb.[i] |> int
let number = number - 1
let number = if number < 0 then 9 else number
sb.[i] <- number.ToString()[0]
printfn "\nThe new string:"
printfn $"{sb}"
// The example displays the following output:
// The original string:
// 1,457,531,530.00000940,522,609.000001,668,113,564.000001,998,992,883.000001,792,660,834.00
// 000101,203,251.000002,051,183,075.000002,066,000,067.000001,643,701,043.000001,702,382,508
// .00000
//
// The new string:
// 0,346,420,429.99999839,411,598.999990,557,002,453.999990,887,881,772.999990,681,559,723.99
// 999090,192,140.999991,940,072,964.999991,955,999,956.999990,532,690,932.999990,691,271,497
// .99999
Imports System.Globalization
Imports System.Text
Module Example4
Public Sub Main()
Dim rnd As New Random()
Dim sb As New StringBuilder()
' Generate 10 random numbers and store them in a StringBuilder.
For ctr As Integer = 0 To 9
sb.Append(rnd.Next().ToString("N5"))
Next
Console.WriteLine("The original string:")
Console.WriteLine(sb.ToString())
Console.WriteLine()
' Decrease each number by one.
For ctr As Integer = 0 To sb.Length - 1
If Char.GetUnicodeCategory(sb(ctr)) = UnicodeCategory.DecimalDigitNumber Then
Dim number As Integer = CType(Char.GetNumericValue(sb(ctr)), Integer)
number -= 1
If number < 0 Then number = 9
sb(ctr) = number.ToString()(0)
End If
Next
Console.WriteLine("The new string:")
Console.WriteLine(sb.ToString())
End Sub
End Module
' The example displays the following output:
' The original string:
' 1,457,531,530.00000940,522,609.000001,668,113,564.000001,998,992,883.000001,792,660,834.00
' 000101,203,251.000002,051,183,075.000002,066,000,067.000001,643,701,043.000001,702,382,508
' .00000
'
' The new string:
' 0,346,420,429.99999839,411,598.999990,557,002,453.999990,887,881,772.999990,681,559,723.99
' 999090,192,140.999991,940,072,964.999991,955,999,956.999990,532,690,932.999990,691,271,497
' .99999
Menggunakan pengindeksan berbasis karakter dengan Chars[] properti bisa sangat lambat dalam kondisi berikut:
- StringBuilder Instansnya besar (misalnya, terdiri dari beberapa puluh ribu karakter).
- Itu StringBuilder adalah "chunky." Artinya, panggilan berulang ke metode seperti StringBuilder.Append telah secara otomatis memperluas properti objek StringBuilder.Capacity dan mengalokasikan gugus memori baru untuknya.
Performa sangat terpengaruh karena setiap akses karakter memandu seluruh daftar gugus yang ditautkan untuk menemukan buffer yang benar untuk diindeks.
Catatan
Bahkan untuk objek "chunky" StringBuilder besar, menggunakan Chars[] properti untuk akses berbasis indeks ke satu atau sejumlah kecil karakter memiliki dampak performa yang dapat diabaikan; biasanya, ini adalah operasi O(n ). Dampak performa yang signifikan terjadi ketika mengulangi karakter dalam StringBuilder objek, yang merupakan operasi O(n^2).
Jika Anda mengalami masalah performa saat menggunakan pengindeksan berbasis karakter dengan StringBuilder objek, Anda dapat menggunakan salah satu solusi berikut:
Konversikan StringBuilder instans menjadi String dengan memanggil ToString metode , lalu akses karakter dalam string.
Salin konten objek yang ada StringBuilder ke objek pra-ukuran StringBuilder baru. Performa meningkat karena objek baru StringBuilder tidak gugus. Misalnya:
// sbOriginal is the existing StringBuilder object var sbNew = new StringBuilder(sbOriginal.ToString(), sbOriginal.Length);' sbOriginal is the existing StringBuilder object Dim sbNew = New StringBuilder(sbOriginal.ToString(), sbOriginal.Length)Atur kapasitas StringBuilder awal objek ke nilai yang kira-kira sama dengan ukuran maksimum yang diharapkan dengan memanggil StringBuilder(Int32) konstruktor. Perhatikan bahwa ini mengalokasikan seluruh blok memori meskipun StringBuilder jarang mencapai kapasitas maksimumnya.
Menambahkan teks ke objek StringBuilder
Kelas StringBuilder ini mencakup metode berikut untuk memperluas konten StringBuilder objek:
Metode ini Append menambahkan string, substring, array karakter, bagian dari array karakter, satu karakter yang diulang beberapa kali, atau representasi string dari jenis data primitif ke StringBuilder objek.
Metode menambahkan AppendLine terminator baris atau string bersama dengan terminator garis ke StringBuilder objek.
Metode menambahkan AppendFormat string format komposit ke StringBuilder objek. Representasi string objek yang disertakan dalam string hasil dapat mencerminkan konvensi pemformatan budaya sistem saat ini atau budaya tertentu.
Metode Insert ini menyisipkan string, substring, beberapa pengulangan string, array karakter, bagian dari array karakter, atau representasi string dari jenis data primitif pada posisi tertentu dalam StringBuilder objek. Posisi didefinisikan oleh indeks berbasis nol.
Contoh berikut menggunakan Appendmetode , , AppendLineAppendFormat, dan Insert untuk memperluas teks StringBuilder objek.
using System;
using System.Text;
public class Example6
{
public static void Main()
{
// Create a StringBuilder object with no text.
StringBuilder sb = new StringBuilder();
// Append some text.
sb.Append('*', 10).Append(" Adding Text to a StringBuilder Object ").Append('*', 10);
sb.AppendLine("\n");
sb.AppendLine("Some code points and their corresponding characters:");
// Append some formatted text.
for (int ctr = 50; ctr <= 60; ctr++)
{
sb.AppendFormat("{0,12:X4} {1,12}", ctr, Convert.ToChar(ctr));
sb.AppendLine();
}
// Find the end of the introduction to the column.
int pos = sb.ToString().IndexOf("characters:") + 11 +
Environment.NewLine.Length;
// Insert a column header.
sb.Insert(pos, String.Format("{2}{0,12:X4} {1,12}{2}", "Code Unit",
"Character", "\n"));
// Convert the StringBuilder to a string and display it.
Console.WriteLine(sb.ToString());
}
}
// The example displays the following output:
// ********** Adding Text to a StringBuilder Object **********
//
// Some code points and their corresponding characters:
//
// Code Unit Character
// 0032 2
// 0033 3
// 0034 4
// 0035 5
// 0036 6
// 0037 7
// 0038 8
// 0039 9
// 003A :
// 003B ;
// 003C <
open System
open System.Text
// Create a StringBuilder object with no text.
let sb = StringBuilder()
// Append some text.
sb
.Append('*', 10)
.Append(" Adding Text to a StringBuilder Object ")
.Append('*', 10)
|> ignore
sb.AppendLine "\n" |> ignore
sb.AppendLine "Some code points and their corresponding characters:" |> ignore
// Append some formatted text.
for i = 50 to 60 do
sb.AppendFormat("{0,12:X4} {1,12}", i, Convert.ToChar i) |> ignore
sb.AppendLine() |> ignore
// Find the end of the introduction to the column.
let pos = (string sb).IndexOf("characters:") + 11 + Environment.NewLine.Length
// Insert a column header.
sb.Insert(pos, String.Format("{2}{0,12:X4} {1,12}{2}", "Code Unit", "Character", "\n"))
|> ignore
// Convert the StringBuilder to a string and display it.
printfn $"{sb}"
// The example displays the following output:
// ********** Adding Text to a StringBuilder Object **********
//
// Some code points and their corresponding characters:
//
// Code Unit Character
// 0032 2
// 0033 3
// 0034 4
// 0035 5
// 0036 6
// 0037 7
// 0038 8
// 0039 9
// 003A :
// 003B ;
// 003C <
Imports System.Text
Module Example7
Public Sub Main()
' Create a StringBuilder object with no text.
Dim sb As New StringBuilder()
' Append some text.
sb.Append("*"c, 10).Append(" Adding Text to a StringBuilder Object ").Append("*"c, 10)
sb.AppendLine()
sb.AppendLine()
sb.AppendLine("Some code points and their corresponding characters:")
' Append some formatted text.
For ctr = 50 To 60
sb.AppendFormat("{0,12:X4} {1,12}", ctr, Convert.ToChar(ctr))
sb.AppendLine()
Next
' Find the end of the introduction to the column.
Dim pos As Integer = sb.ToString().IndexOf("characters:") + 11 +
Environment.NewLine.Length
' Insert a column header.
sb.Insert(pos, String.Format("{2}{0,12:X4} {1,12}{2}", "Code Unit",
"Character", vbCrLf))
' Convert the StringBuilder to a string and display it.
Console.WriteLine(sb.ToString())
End Sub
End Module
' The example displays the following output:
' ********** Adding Text to a StringBuilder Object **********
'
' Some code points and their corresponding characters:
'
' Code Unit Character
' 0032 2
' 0033 3
' 0034 4
' 0035 5
' 0036 6
' 0037 7
' 0038 8
' 0039 9
' 003A :
' 003B ;
' 003C <
Menghapus teks dari objek StringBuilder
Kelas StringBuilder ini mencakup metode yang dapat mengurangi ukuran instans saat ini StringBuilder . Metode Clear menghapus semua karakter dan mengatur Length properti ke nol. Metode Remove menghapus jumlah karakter tertentu yang dimulai pada posisi indeks tertentu. Selain itu, Anda dapat menghapus karakter dari akhir StringBuilder objek dengan mengatur propertinya Length ke nilai yang kurang dari panjang instans saat ini.
Contoh berikut menghapus beberapa teks dari StringBuilder objek, menampilkan kapasitas yang dihasilkan, kapasitas maksimum, dan nilai properti panjang, lalu memanggil Clear metode untuk menghapus semua karakter dari StringBuilder objek.
using System;
using System.Text;
public class Example5
{
public static void Main()
{
StringBuilder sb = new StringBuilder("A StringBuilder object");
ShowSBInfo(sb);
// Remove "object" from the text.
string textToRemove = "object";
int pos = sb.ToString().IndexOf(textToRemove);
if (pos >= 0)
{
sb.Remove(pos, textToRemove.Length);
ShowSBInfo(sb);
}
// Clear the StringBuilder contents.
sb.Clear();
ShowSBInfo(sb);
}
public static void ShowSBInfo(StringBuilder sb)
{
Console.WriteLine("\nValue: {0}", sb.ToString());
foreach (var prop in sb.GetType().GetProperties())
{
if (prop.GetIndexParameters().Length == 0)
Console.Write("{0}: {1:N0} ", prop.Name, prop.GetValue(sb));
}
Console.WriteLine();
}
}
// The example displays the following output:
// Value: A StringBuilder object
// Capacity: 22 MaxCapacity: 2,147,483,647 Length: 22
//
// Value: A StringBuilder
// Capacity: 22 MaxCapacity: 2,147,483,647 Length: 16
//
// Value:
// Capacity: 22 MaxCapacity: 2,147,483,647 Length: 0
open System.Text
let showSBInfo (sb: StringBuilder) =
for prop in sb.GetType().GetProperties() do
if prop.GetIndexParameters().Length = 0 then
printf $"{prop.Name}: {prop.GetValue sb:N0} "
printfn ""
let sb = StringBuilder "A StringBuilder object"
showSBInfo sb
// Remove "object" from the text.
let textToRemove = "object"
let pos = (string sb).IndexOf textToRemove
if pos >= 0 then
sb.Remove(pos, textToRemove.Length) |> ignore
showSBInfo sb
// Clear the StringBuilder contents.
sb.Clear() |> ignore
showSBInfo sb
// The example displays the following output:
// Value: A StringBuilder object
// Capacity: 22 MaxCapacity: 2,147,483,647 Length: 22
//
// Value: A StringBuilder
// Capacity: 22 MaxCapacity: 2,147,483,647 Length: 16
//
// Value:
// Capacity: 22 MaxCapacity: 2,147,483,647 Length: 0
Imports System.Text
Module Example6
Public Sub Main()
Dim sb As New StringBuilder("A StringBuilder object")
ShowSBInfo(sb)
' Remove "object" from the text.
Dim textToRemove As String = "object"
Dim pos As Integer = sb.ToString().IndexOf(textToRemove)
If pos >= 0 Then
sb.Remove(pos, textToRemove.Length)
ShowSBInfo(sb)
End If
' Clear the StringBuilder contents.
sb.Clear()
ShowSBInfo(sb)
End Sub
Public Sub ShowSBInfo(sb As StringBuilder)
Console.WriteLine()
Console.WriteLine("Value: {0}", sb.ToString())
For Each prop In sb.GetType().GetProperties
If prop.GetIndexParameters().Length = 0 Then
Console.Write("{0}: {1:N0} ", prop.Name, prop.GetValue(sb))
End If
Next
Console.WriteLine()
End Sub
End Module
' The example displays the following output:
' Value: A StringBuilder object
' Capacity: 22 MaxCapacity: 2,147,483,647 Length: 22
'
' Value: A StringBuilder
' Capacity: 22 MaxCapacity: 2,147,483,647 Length: 16
'
' Value:
' Capacity: 22 MaxCapacity: 2,147,483,647 Length: 0
Mengubah teks dalam objek StringBuilder
Metode ini StringBuilder.Replace menggantikan semua kemunculan karakter atau string di seluruh StringBuilder objek atau dalam rentang karakter tertentu. Contoh berikut menggunakan Replace metode untuk mengganti semua tanda seru (!) dengan tanda tanya (?) dalam StringBuilder objek.
using System;
using System.Text;
public class Example13
{
public static void Main()
{
StringBuilder MyStringBuilder = new StringBuilder("Hello World!");
MyStringBuilder.Replace('!', '?');
Console.WriteLine(MyStringBuilder);
}
}
// The example displays the following output:
// Hello World?
open System.Text
let myStringBuilder = StringBuilder "Hello World!"
myStringBuilder.Replace('!', '?') |> ignore
printfn $"{myStringBuilder}"
// The example displays the following output:
// Hello World?
Imports System.Text
Module Example
Public Sub Main()
Dim MyStringBuilder As New StringBuilder("Hello World!")
MyStringBuilder.Replace("!"c, "?"c)
Console.WriteLine(MyStringBuilder)
End Sub
End Module
' The example displays the following output:
' Hello World?
Mencari teks dalam objek StringBuilder
Kelas StringBuilder tidak menyertakan metode yang mirip String.Containsdengan metode , , String.IndexOfdan String.StartsWith yang disediakan oleh String kelas , yang memungkinkan Anda mencari objek untuk karakter tertentu atau substring. Menentukan posisi karakter kehadiran atau awal substring mengharuskan Anda mencari String nilai dengan menggunakan metode pencarian string atau metode ekspresi reguler. Ada empat cara untuk menerapkan pencarian tersebut, seperti yang ditunjukkan tabel berikut.
| Teknik | Pro | Kontra |
|---|---|---|
| Cari nilai string sebelum menambahkannya ke StringBuilder objek. | Berguna untuk menentukan apakah substring ada. | Tidak dapat digunakan ketika posisi indeks substring penting. |
| Panggil ToString dan cari objek yang dikembalikan String . | Mudah digunakan jika Anda menetapkan semua teks ke StringBuilder objek, lalu mulai mengubahnya. | Rumit untuk berulang kali memanggil ToString jika Anda harus melakukan modifikasi sebelum semua teks ditambahkan ke StringBuilder objek. Anda harus ingat untuk bekerja dari akhir StringBuilder teks objek jika Anda membuat perubahan. |
| Chars[] Gunakan properti untuk mencari rentang karakter secara berurutan. | Berguna jika Anda khawatir dengan karakter individual atau substring kecil. | Rumit jika jumlah karakter yang akan dicari besar atau jika logika pencarian rumit. Menghasilkan performa yang sangat buruk untuk objek yang telah tumbuh sangat besar melalui panggilan metode berulang. |
| Konversi objek StringBuilder menjadi String objek, dan lakukan modifikasi pada String objek. | Berguna jika jumlah modifikasi kecil. | Meniadakan manfaat StringBuilder performa kelas jika jumlah modifikasi besar. |
Mari kita periksa teknik ini secara lebih rinci.
Jika tujuan pencarian adalah untuk menentukan apakah substring tertentu ada (yaitu, jika Anda tidak tertarik pada posisi substring), Anda dapat mencari string sebelum menyimpannya di StringBuilder objek. Contoh berikut memberikan satu kemungkinan implementasi. Ini mendefinisikan
StringBuilderFinderkelas yang konstruktornya diteruskan referensi ke StringBuilder objek dan substring untuk ditemukan dalam string. Dalam hal ini, contoh mencoba menentukan apakah suhu yang direkam berada di Fahrenheit atau Celcius, dan menambahkan teks pengantar StringBuilder yang sesuai ke awal objek. Generator angka acak digunakan untuk memilih array yang berisi data dalam derajat Celcius atau derajat Fahrenheit.using System; using System.Text; public class Example9 { public static void Main() { Random rnd = new Random(); string[] tempF = { "47.6F", "51.3F", "49.5F", "62.3F" }; string[] tempC = { "21.2C", "16.1C", "23.5C", "22.9C" }; string[][] temps = { tempF, tempC }; StringBuilder sb = new StringBuilder(); var f = new StringBuilderFinder(sb, "F"); var baseDate = new DateTime(2013, 5, 1); String[] temperatures = temps[rnd.Next(2)]; bool isFahrenheit = false; foreach (var temperature in temperatures) { if (isFahrenheit) sb.AppendFormat("{0:d}: {1}\n", baseDate, temperature); else isFahrenheit = f.SearchAndAppend(String.Format("{0:d}: {1}\n", baseDate, temperature)); baseDate = baseDate.AddDays(1); } if (isFahrenheit) { sb.Insert(0, "Average Daily Temperature in Degrees Fahrenheit"); sb.Insert(47, "\n\n"); } else { sb.Insert(0, "Average Daily Temperature in Degrees Celsius"); sb.Insert(44, "\n\n"); } Console.WriteLine(sb.ToString()); } } public class StringBuilderFinder { private StringBuilder sb; private String text; public StringBuilderFinder(StringBuilder sb, String textToFind) { this.sb = sb; this.text = textToFind; } public bool SearchAndAppend(String stringToSearch) { sb.Append(stringToSearch); return stringToSearch.Contains(text); } } // The example displays output similar to the following: // Average Daily Temperature in Degrees Celsius // // 5/1/2013: 21.2C // 5/2/2013: 16.1C // 5/3/2013: 23.5C // 5/4/2013: 22.9Copen System open System.Text type StringBuilderFinder(sb: StringBuilder, textToFind: string) = member _.SearchAndAppend(stringToSearch: string) = sb.Append stringToSearch |> ignore stringToSearch.Contains textToFind let tempF = [| "47.6F"; "51.3F"; "49.5F"; "62.3F" |] let tempC = [| "21.2C"; "16.1C"; "23.5C"; "22.9C" |] let temps = [| tempF; tempC |] let sb = StringBuilder() let f = StringBuilderFinder(sb, "F") let temperatures = temps[Random.Shared.Next(2)] let mutable baseDate = DateTime(2013, 5, 1) let mutable isFahrenheit = false for temperature in temperatures do if isFahrenheit then sb.AppendFormat("{0:d}: {1}\n", baseDate, temperature) |> ignore else isFahrenheit <- $"{baseDate:d}: {temperature}\n" |> f.SearchAndAppend baseDate <- baseDate.AddDays 1 if isFahrenheit then sb.Insert(0, "Average Daily Temperature in Degrees Fahrenheit") |> ignore sb.Insert(47, "\n\n") |> ignore else sb.Insert(0, "Average Daily Temperature in Degrees Celsius") |> ignore sb.Insert(44, "\n\n") |> ignore printfn $"{sb}" // The example displays output similar to the following: // Average Daily Temperature in Degrees Celsius // // 5/1/2013: 21.2C // 5/2/2013: 16.1C // 5/3/2013: 23.5C // 5/4/2013: 22.9CImports System.Text Module Example9 Public Sub Main() Dim rnd As New Random() Dim tempF() As String = {"47.6F", "51.3F", "49.5F", "62.3F"} Dim tempC() As String = {"21.2C", "16.1C", "23.5C", "22.9C"} Dim temps()() As String = {tempF, tempC} Dim sb As StringBuilder = New StringBuilder() Dim f As New StringBuilderFinder(sb, "F") Dim baseDate As New DateTime(2013, 5, 1) Dim temperatures() As String = temps(rnd.Next(2)) Dim isFahrenheit As Boolean = False For Each temperature In temperatures If isFahrenheit Then sb.AppendFormat("{0:d}: {1}{2}", baseDate, temperature, vbCrLf) Else isFahrenheit = f.SearchAndAppend(String.Format("{0:d}: {1}{2}", baseDate, temperature, vbCrLf)) End If baseDate = baseDate.AddDays(1) Next If isFahrenheit Then sb.Insert(0, "Average Daily Temperature in Degrees Fahrenheit") sb.Insert(47, vbCrLf + vbCrLf) Else sb.Insert(0, "Average Daily Temperature in Degrees Celsius") sb.Insert(44, vbCrLf + vbCrLf) End If Console.WriteLine(sb.ToString()) End Sub End Module Public Class StringBuilderFinder Private sb As StringBuilder Private text As String Public Sub New(sb As StringBuilder, textToFind As String) Me.sb = sb text = textToFind End Sub Public Function SearchAndAppend(stringToSearch As String) As Boolean sb.Append(stringToSearch) Return stringToSearch.Contains(text) End Function End Class ' The example displays output similar to the following: ' Average Daily Temperature in Degrees Celsius ' ' 5/1/2013: 21.2C ' 5/2/2013: 16.1C ' 5/3/2013: 23.5C ' 5/4/2013: 22.9CStringBuilder.ToString Panggil metode untuk mengonversi StringBuilder objek menjadi String objek. Anda dapat mencari string dengan menggunakan metode seperti String.LastIndexOf atau String.StartsWith, atau Anda dapat menggunakan ekspresi reguler dan Regex kelas untuk mencari pola. Karena objek StringBuilder dan String menggunakan pengodean UTF-16 untuk menyimpan karakter, posisi indeks karakter, substring, dan kecocokan ekspresi reguler sama di kedua objek. Ini memungkinkan Anda menggunakan StringBuilder metode untuk membuat perubahan pada posisi yang sama di mana teks tersebut String ditemukan di objek.
Catatan
Jika Anda mengadopsi pendekatan ini, Anda harus bekerja dari akhir StringBuilder objek ke awalnya sehingga Anda tidak perlu mengonversi StringBuilder objek menjadi string berulang kali.
Contoh berikut menggambarkan pendekatan ini. Ini menyimpan empat kemunculan setiap huruf alfabet bahasa Inggris dalam objek StringBuilder . Kemudian mengonversi teks menjadi String objek dan menggunakan ekspresi reguler untuk mengidentifikasi posisi awal setiap urutan empat karakter. Akhirnya, ia menambahkan garis bawah sebelum setiap urutan empat karakter kecuali untuk urutan pertama, dan mengonversi karakter pertama dari urutan menjadi huruf besar.
using System; using System.Text; using System.Text.RegularExpressions; public class Example10 { public static void Main() { // Create a StringBuilder object with 4 successive occurrences // of each character in the English alphabet. StringBuilder sb = new StringBuilder(); for (ushort ctr = (ushort)'a'; ctr <= (ushort)'z'; ctr++) sb.Append(Convert.ToChar(ctr), 4); // Create a parallel string object. String sbString = sb.ToString(); // Determine where each new character sequence begins. String pattern = @"(\w)\1+"; MatchCollection matches = Regex.Matches(sbString, pattern); // Uppercase the first occurrence of the sequence, and separate it // from the previous sequence by an underscore character. for (int ctr = matches.Count - 1; ctr >= 0; ctr--) { Match m = matches[ctr]; sb[m.Index] = Char.ToUpper(sb[m.Index]); if (m.Index > 0) sb.Insert(m.Index, "_"); } // Display the resulting string. sbString = sb.ToString(); int line = 0; do { int nChars = line * 80 + 79 <= sbString.Length ? 80 : sbString.Length - line * 80; Console.WriteLine(sbString.Substring(line * 80, nChars)); line++; } while (line * 80 < sbString.Length); } } // The example displays the following output: // Aaaa_Bbbb_Cccc_Dddd_Eeee_Ffff_Gggg_Hhhh_Iiii_Jjjj_Kkkk_Llll_Mmmm_Nnnn_Oooo_Pppp_ // Qqqq_Rrrr_Ssss_Tttt_Uuuu_Vvvv_Wwww_Xxxx_Yyyy_Zzzzopen System open System.Text open System.Text.RegularExpressions // Create a StringBuilder object with 4 successive occurrences // of each character in the English alphabet. let sb = StringBuilder() for char in 'a' .. 'z' do sb.Append(char, 4) |> ignore // Create a parallel string object. let sbString = string sb // Determine where each new character sequence begins. let pattern = @"(\w)\1+" let matches = Regex.Matches(sbString, pattern) // Uppercase the first occurrence of the sequence, and separate it // from the previous sequence by an underscore character. for i = matches.Count - 1 downto 0 do let m = matches[i] sb[m.Index] <- Char.ToUpper sb[m.Index] if m.Index > 0 then sb.Insert(m.Index, "_") |> ignore // Display the resulting string. let sbString2 = string sb for line = 0 to (sbString2.Length - 1) / 80 do let nChars = if line * 80 + 79 <= sbString2.Length then 80 else sbString2.Length - line * 80 printfn $"{sbString2.Substring(line * 80, nChars)}" // The example displays the following output: // Aaaa_Bbbb_Cccc_Dddd_Eeee_Ffff_Gggg_Hhhh_Iiii_Jjjj_Kkkk_Llll_Mmmm_Nnnn_Oooo_Pppp_ // Qqqq_Rrrr_Ssss_Tttt_Uuuu_Vvvv_Wwww_Xxxx_Yyyy_ZzzzImports System.Text Imports System.Text.RegularExpressions Module Example10 Public Sub Main() ' Create a StringBuilder object with 4 successive occurrences ' of each character in the English alphabet. Dim sb As New StringBuilder() For ctr As UShort = AscW("a") To AscW("z") sb.Append(ChrW(ctr), 4) Next ' Create a parallel string object. Dim sbString As String = sb.ToString() ' Determine where each new character sequence begins. Dim pattern As String = "(\w)\1+" Dim matches As MatchCollection = Regex.Matches(sbString, pattern) ' Uppercase the first occurrence of the sequence, and separate it ' from the previous sequence by an underscore character. For ctr As Integer = matches.Count - 1 To 0 Step -1 Dim m As Match = matches(ctr) sb.Chars(m.Index) = Char.ToUpper(sb.Chars(m.Index)) If m.Index > 0 Then sb.Insert(m.Index, "_") Next ' Display the resulting string. sbString = sb.ToString() Dim line As Integer = 0 Do Dim nChars As Integer = If(line * 80 + 79 <= sbString.Length, 80, sbString.Length - line * 80) Console.WriteLine(sbString.Substring(line * 80, nChars)) line += 1 Loop While line * 80 < sbString.Length End Sub End Module ' The example displays the following output: ' Aaaa_Bbbb_Cccc_Dddd_Eeee_Ffff_Gggg_Hhhh_Iiii_Jjjj_Kkkk_Llll_Mmmm_Nnnn_Oooo_Pppp_ ' Qqqq_Rrrr_Ssss_Tttt_Uuuu_Vvvv_Wwww_Xxxx_Yyyy_ZzzzStringBuilder.Chars[] Gunakan properti untuk mencari rentang karakter secara berurutan dalam objekStringBuilder. Pendekatan ini mungkin tidak praktis jika jumlah karakter yang akan dicari besar atau logika pencarian sangat kompleks. Untuk implikasi performa akses berbasis indeks karakter demi karakter untuk objek yang sangat besar dan terpotong StringBuilder , lihat dokumentasi untuk StringBuilder.Chars[] properti .
Contoh berikut identik dalam fungsionalitas dengan contoh sebelumnya tetapi berbeda dalam implementasi. Ini menggunakan Chars[] properti untuk mendeteksi kapan nilai karakter telah berubah, menyisipkan garis bawah pada posisi tersebut, dan mengonversi karakter pertama dalam urutan baru menjadi huruf besar.
using System; using System.Text; public class Example11 { public static void Main() { // Create a StringBuilder object with 4 successive occurrences // of each character in the English alphabet. StringBuilder sb = new StringBuilder(); for (ushort ctr = (ushort)'a'; ctr <= (ushort)'z'; ctr++) sb.Append(Convert.ToChar(ctr), 4); // Iterate the text to determine when a new character sequence occurs. int position = 0; Char current = '\u0000'; do { if (sb[position] != current) { current = sb[position]; sb[position] = Char.ToUpper(sb[position]); if (position > 0) sb.Insert(position, "_"); position += 2; } else { position++; } } while (position <= sb.Length - 1); // Display the resulting string. String sbString = sb.ToString(); int line = 0; do { int nChars = line * 80 + 79 <= sbString.Length ? 80 : sbString.Length - line * 80; Console.WriteLine(sbString.Substring(line * 80, nChars)); line++; } while (line * 80 < sbString.Length); } } // The example displays the following output: // Aaaa_Bbbb_Cccc_Dddd_Eeee_Ffff_Gggg_Hhhh_Iiii_Jjjj_Kkkk_Llll_Mmmm_Nnnn_Oooo_Pppp_ // Qqqq_Rrrr_Ssss_Tttt_Uuuu_Vvvv_Wwww_Xxxx_Yyyy_Zzzzopen System open System.Text // Create a StringBuilder object with 4 successive occurrences // of each character in the English alphabet. let sb = StringBuilder() for char in 'a' .. 'z' do sb.Append(char, 4) |> ignore // Iterate the text to determine when a new character sequence occurs. let mutable position = 0 let mutable current = '\u0000' while position <= sb.Length - 1 do if sb[position] <> current then current <- sb[position] sb[position] <- Char.ToUpper sb[position] if position > 0 then sb.Insert(position, "_") |> ignore position <- position + 2 else position <- position + 1 // Display the resulting string. let sbString = string sb for line = 0 to (sbString.Length - 1) / 80 do let nChars = if line * 80 + 79 <= sbString.Length then 80 else sbString.Length - line * 80 printfn $"{sbString.Substring(line * 80, nChars)}" // The example displays the following output: // Aaaa_Bbbb_Cccc_Dddd_Eeee_Ffff_Gggg_Hhhh_Iiii_Jjjj_Kkkk_Llll_Mmmm_Nnnn_Oooo_Pppp_ // Qqqq_Rrrr_Ssss_Tttt_Uuuu_Vvvv_Wwww_Xxxx_Yyyy_ZzzzImports System.Text Module Example11 Public Sub Main() ' Create a StringBuilder object with 4 successive occurrences ' of each character in the English alphabet. Dim sb As New StringBuilder() For ctr As UShort = AscW("a") To AscW("z") sb.Append(ChrW(ctr), 4) Next ' Iterate the text to determine when a new character sequence occurs. Dim position As Integer = 0 Dim current As Char = ChrW(0) Do If sb(position) <> current Then current = sb(position) sb(position) = Char.ToUpper(sb(position)) If position > 0 Then sb.Insert(position, "_") position += 2 Else position += 1 End If Loop While position <= sb.Length - 1 ' Display the resulting string. Dim sbString As String = sb.ToString() Dim line As Integer = 0 Do Dim nChars As Integer = If(line * 80 + 79 <= sbString.Length, 80, sbString.Length - line * 80) Console.WriteLine(sbString.Substring(line * 80, nChars)) line += 1 Loop While line * 80 < sbString.Length End Sub End Module ' The example displays the following output: ' Aaaa_Bbbb_Cccc_Dddd_Eeee_Ffff_Gggg_Hhhh_Iiii_Jjjj_Kkkk_Llll_Mmmm_Nnnn_Oooo_Pppp_ ' Qqqq_Rrrr_Ssss_Tttt_Uuuu_Vvvv_Wwww_Xxxx_Yyyy_ZzzzSimpan semua teks yang tidak dimodifikasi dalam StringBuilder objek, panggil StringBuilder.ToString metode untuk mengonversi StringBuilder objek menjadi String objek, dan melakukan modifikasi pada String objek. Anda dapat menggunakan pendekatan ini jika Anda hanya memiliki beberapa modifikasi; jika tidak, biaya bekerja dengan string yang tidak dapat diubah dapat meniadakan manfaat performa menggunakan StringBuilder objek.
Contoh berikut identik dalam fungsionalitas dengan dua contoh sebelumnya tetapi berbeda dalam implementasi. Ini membuat StringBuilder objek, mengonversinya menjadi String objek, lalu menggunakan ekspresi reguler untuk melakukan semua modifikasi yang tersisa pada string. Metode ini Regex.Replace(String, String, MatchEvaluator) menggunakan ekspresi lambda untuk melakukan penggantian pada setiap kecocokan.
using System; using System.Text; using System.Text.RegularExpressions; public class Example12 { public static void Main() { // Create a StringBuilder object with 4 successive occurrences // of each character in the English alphabet. StringBuilder sb = new StringBuilder(); for (ushort ctr = (ushort)'a'; ctr <= (ushort)'z'; ctr++) sb.Append(Convert.ToChar(ctr), 4); // Convert it to a string. String sbString = sb.ToString(); // Use a regex to uppercase the first occurrence of the sequence, // and separate it from the previous sequence by an underscore. string pattern = @"(\w)(\1+)"; sbString = Regex.Replace(sbString, pattern, m => (m.Index > 0 ? "_" : "") + m.Groups[1].Value.ToUpper() + m.Groups[2].Value); // Display the resulting string. int line = 0; do { int nChars = line * 80 + 79 <= sbString.Length ? 80 : sbString.Length - line * 80; Console.WriteLine(sbString.Substring(line * 80, nChars)); line++; } while (line * 80 < sbString.Length); } } // The example displays the following output: // Aaaa_Bbbb_Cccc_Dddd_Eeee_Ffff_Gggg_Hhhh_Iiii_Jjjj_Kkkk_Llll_Mmmm_Nnnn_Oooo_Pppp_ // Qqqq_Rrrr_Ssss_Tttt_Uuuu_Vvvv_Wwww_Xxxx_Yyyy_Zzzzopen System.Text open System.Text.RegularExpressions // Create a StringBuilder object with 4 successive occurrences // of each character in the English alphabet. let sb = StringBuilder() for char in 'a' .. 'z' do sb.Append(char, 4) |> ignore // Convert it to a string. let sbString = string sb // Use a regex to uppercase the first occurrence of the sequence, // and separate it from the previous sequence by an underscore. let pattern = @"(\w)(\1+)" let sbStringReplaced = Regex.Replace( sbString, pattern, fun m -> (if m.Index > 0 then "_" else "") + m.Groups[ 1 ].Value.ToUpper() + m.Groups[2].Value ) // Display the resulting string. for line = 0 to (sbStringReplaced.Length - 1) / 80 do let nChars = if line * 80 + 79 <= sbStringReplaced.Length then 80 else sbStringReplaced.Length - line * 80 printfn $"{sbStringReplaced.Substring(line * 80, nChars)}" // The example displays the following output: // Aaaa_Bbbb_Cccc_Dddd_Eeee_Ffff_Gggg_Hhhh_Iiii_Jjjj_Kkkk_Llll_Mmmm_Nnnn_Oooo_Pppp_ // Qqqq_Rrrr_Ssss_Tttt_Uuuu_Vvvv_Wwww_Xxxx_Yyyy_ZzzzImports System.Text Imports System.Text.RegularExpressions Module Example12 Public Sub Main() ' Create a StringBuilder object with 4 successive occurrences ' of each character in the English alphabet. Dim sb As New StringBuilder() For ctr As UShort = AscW("a") To AscW("z") sb.Append(ChrW(ctr), 4) Next ' Convert it to a string. Dim sbString As String = sb.ToString() ' Use a regex to uppercase the first occurrence of the sequence, ' and separate it from the previous sequence by an underscore. Dim pattern As String = "(\w)(\1+)" sbString = Regex.Replace(sbString, pattern, Function(m) If(m.Index > 0, "_", "") + m.Groups(1).Value.ToUpper + m.Groups(2).Value) ' Display the resulting string. Dim line As Integer = 0 Do Dim nChars As Integer = If(line * 80 + 79 <= sbString.Length, 80, sbString.Length - line * 80) Console.WriteLine(sbString.Substring(line * 80, nChars)) line += 1 Loop While line * 80 < sbString.Length End Sub End Module ' The example displays the following output: ' Aaaa_Bbbb_Cccc_Dddd_Eeee_Ffff_Gggg_Hhhh_Iiii_Jjjj_Kkkk_Llll_Mmmm_Nnnn_Oooo_Pppp_ ' Qqqq_Rrrr_Ssss_Tttt_Uuuu_Vvvv_Wwww_Xxxx_Yyyy_Zzzz
Mengonversi objek StringBuilder menjadi string
Anda harus mengonversi objek StringBuilder menjadi objek String sebelum dapat meneruskan string yang direpresentasikan oleh objek StringBuilder ke metode yang memiliki parameter String atau menampilkannya di antarmuka pengguna. Anda melakukan konversi ini dengan memanggil StringBuilder.ToString metode . Untuk ilustrasi, lihat contoh sebelumnya, yang memanggil ToString metode untuk mengonversi StringBuilder objek ke string sehingga dapat diteruskan ke metode ekspresi reguler.
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk