Struktur System.Numerics.BigInteger

Artikel ini menyediakan keterangan tambahan untuk dokumentasi referensi untuk API ini.

Jenis BigInteger adalah jenis yang tidak dapat diubah yang mewakili bilangan bulat besar yang nilainya secara teori tidak memiliki batas atas atau bawah. Anggota tipe BigInteger mirip dengan tipe integral lainnya (tipe Byte, Int16, Int32, Int64, SByte, UInt16, UInt32, dan UInt64). Jenis ini berbeda dari jenis integral lainnya di .NET, yang memiliki rentang yang ditunjukkan oleh properti MinValue dan MaxValue mereka.

Nota

Karena jenis BigInteger tidak dapat diubah (lihat Mutabilitas) dan karena tidak memiliki batas atas atau bawah, OutOfMemoryException dapat dilemparkan untuk operasi apa pun yang menyebabkan nilai BigInteger tumbuh terlalu besar.

Menginstansiasi objek BigInteger

Anda dapat membuat instans objek BigInteger dengan beberapa cara:

• Anda dapat menggunakan kata kunci new dan memberikan nilai integral atau floating-point sebagai parameter ke konstruktor BigInteger. (Nilai floating-point dipotong sebelum ditetapkan ke BigInteger.) Contoh berikut mengilustrasikan cara menggunakan kata kunci new untuk membuat instans nilai BigInteger.

  BigInteger bigIntFromDouble = new BigInteger(179032.6541);
  Console.WriteLine(bigIntFromDouble);
  BigInteger bigIntFromInt64 = new BigInteger(934157136952);
  Console.WriteLine(bigIntFromInt64);
  // The example displays the following output:
  //   179032
  //   934157136952
  

  Dim bigIntFromDouble As New BigInteger(179032.6541)
  Console.WriteLine(bigIntFromDouble)
  Dim bigIntFromInt64 As New BigInteger(934157136952)
  Console.WriteLine(bigIntFromInt64)
  ' The example displays the following output:
  '   179032
  '   934157136952
  

• Anda dapat mendeklarasikan variabel BigInteger dan menetapkannya nilai seperti jenis numerik apa pun, selama nilai tersebut adalah jenis integral. Contoh berikut menggunakan penugasan untuk membuat nilai BigInteger dari Int64.

  long longValue = 6315489358112;
  BigInteger assignedFromLong = longValue;
  Console.WriteLine(assignedFromLong);
  // The example displays the following output:
  //   6315489358112
  

  Dim longValue As Long = 6315489358112
  Dim assignedFromLong As BigInteger = longValue
  Console.WriteLine(assignedFromLong)
  ' The example displays the following output:
  '   6315489358112
  

• Anda dapat menetapkan nilai desimal atau floating-point ke objek BigInteger jika Anda mentransmisikan nilai atau mengonversinya terlebih dahulu. Contoh berikut secara eksplisit melemparkan (dalam C#) atau mengonversi (di Visual Basic) nilai Double dan Decimal menjadi BigInteger.

  BigInteger assignedFromDouble = (BigInteger) 179032.6541;
  Console.WriteLine(assignedFromDouble);
  BigInteger assignedFromDecimal = (BigInteger) 64312.65m;
  Console.WriteLine(assignedFromDecimal);
  // The example displays the following output:
  //   179032
  //   64312
  

  Dim assignedFromDouble As BigInteger = CType(179032.6541, BigInteger)
  Console.WriteLine(assignedFromDouble)
  Dim assignedFromDecimal As BigInteger = CType(64312.65D, BigInteger)
  Console.WriteLine(assignedFromDecimal)
  ' The example displays the following output:
  '   179032
  '   64312
  

Metode ini memungkinkan Anda membuat instans objek BigInteger yang nilainya berada dalam rentang salah satu jenis numerik yang ada saja. Anda dapat membuat instans objek BigInteger yang nilainya dapat melebihi rentang jenis numerik yang ada dengan salah satu dari tiga cara:

• Anda dapat menggunakan kata kunci new dan menyediakan array byte dalam ukuran berapa pun ke konstruktor BigInteger.BigInteger. Contohnya:

  byte[] byteArray = { 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0};
  BigInteger newBigInt = new BigInteger(byteArray);
  Console.WriteLine($"The value of newBigInt is {newBigInt} (or 0x{newBigInt:x}).");
  // The example displays the following output:
  //   The value of newBigInt is 4759477275222530853130 (or 0x102030405060708090a).
  

  Dim byteArray() As Byte = {10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0}
  Dim newBigInt As New BigInteger(byteArray)
  Console.WriteLine("The value of newBigInt is {0} (or 0x{0:x}).", newBigInt)
  ' The example displays the following output:
  '   The value of newBigInt is 4759477275222530853130 (or 0x102030405060708090a).
  

• Anda dapat memanggil metode Parse atau TryParse untuk mengonversi representasi string angka menjadi BigInteger. Contohnya:

  string positiveString = "91389681247993671255432112000000";
  string negativeString = "-90315837410896312071002088037140000";
  BigInteger posBigInt = 0;
  BigInteger negBigInt = 0;
  
  try {
     posBigInt = BigInteger.Parse(positiveString);
     Console.WriteLine(posBigInt);
  }
  catch (FormatException)
  {
     Console.WriteLine($"Unable to convert the string '{positiveString}' to a BigInteger value.");
  }
  
  if (BigInteger.TryParse(negativeString, out negBigInt))
    Console.WriteLine(negBigInt);
  else
     Console.WriteLine($"Unable to convert the string '{negativeString}' to a BigInteger value.");
  
  // The example displays the following output:
  //   9.1389681247993671255432112E+31
  //   -9.0315837410896312071002088037E+34
  

  Dim positiveString As String = "91389681247993671255432112000000"
  Dim negativeString As String = "-90315837410896312071002088037140000"
  Dim posBigInt As BigInteger = 0
  Dim negBigInt As BigInteger = 0
  
  Try
      posBigInt = BigInteger.Parse(positiveString)
      Console.WriteLine(posBigInt)
  Catch e As FormatException
      Console.WriteLine("Unable to convert the string '{0}' to a BigInteger value.",
                        positiveString)
  End Try
  
  If BigInteger.TryParse(negativeString, negBigInt) Then
      Console.WriteLine(negBigInt)
  Else
      Console.WriteLine("Unable to convert the string '{0}' to a BigInteger value.",
                         negativeString)
  End If
  ' The example displays the following output:
  '   9.1389681247993671255432112E+31
  '   -9.0315837410896312071002088037E+34
  

• Anda dapat memanggil metode static (Shared di Visual Basic) BigInteger yang melakukan beberapa operasi pada ekspresi numerik dan mengembalikan hasil BigInteger terhitung. Contoh berikut melakukan ini dengan mengkubik UInt64.MaxValue dan menetapkan hasilnya ke BigInteger.

  BigInteger number = BigInteger.Pow(UInt64.MaxValue, 3);
  Console.WriteLine(number);
  // The example displays the following output:
  //    6277101735386680762814942322444851025767571854389858533375
  

  Dim number As BigInteger = BigInteger.Pow(UInt64.MaxValue, 3)
  Console.WriteLine(number)
  ' The example displays the following output:
  ' 6277101735386680762814942322444851025767571854389858533375
  

Nilai yang tidak diinisialisasi dari BigInteger adalah Zero.

Melakukan operasi pada nilai BigInteger

Anda dapat menggunakan instance BigInteger seperti Anda menggunakan jenis bilangan integral lainnya. BigInteger membebani operator numerik standar untuk memungkinkan Anda melakukan operasi matematika dasar seperti penambahan, pengurangan, pembagian, perkalian, dan negasi unary. Anda juga dapat menggunakan operator numerik standar untuk membandingkan dua nilai BigInteger satu sama lain. Seperti tipe integral lainnya, BigInteger juga mendukung operator bitwise And, Or, XOr, geser kiri, dan geser kanan. Untuk bahasa yang tidak mendukung operator kustom, struktur BigInteger juga menyediakan metode yang setara untuk melakukan operasi matematika. Ini termasuk Add, Divide, Multiply, Negate, Subtract, dan beberapa lainnya.

Banyak anggota struktur BigInteger sesuai langsung dengan anggota jenis integral lainnya. Selain itu, BigInteger menambahkan anggota seperti berikut ini:

• Sign, yang mengembalikan nilai yang menunjukkan tanda nilai BigInteger.

• Abs, yang mengembalikan nilai absolut dari nilai BigInteger.

• DivRem, yang mengembalikan kuota dan sisa operasi pembagian.

• GreatestCommonDivisor, yang mengembalikan pembagi persekutuan terbesar dari dua nilai BigInteger.

Banyak dari anggota tambahan ini sesuai dengan anggota kelas Math, yang menyediakan fungsionalitas untuk bekerja dengan jenis numerik primitif.

Mutabilitas

Contoh berikut membuat instans objek BigInteger lalu menaikkan nilainya satu per satu.

BigInteger number = BigInteger.Multiply(Int64.MaxValue, 3);
number++;
Console.WriteLine(number);

Dim number As BigInteger = BigInteger.Multiply(Int64.MaxValue, 3)
number += 1
Console.WriteLine(number)

Meskipun contoh ini tampaknya mengubah nilai objek yang ada, ini bukan masalahnya. BigInteger objek tidak dapat diubah, yang berarti bahwa secara internal, runtime bahasa umum benar-benar membuat objek BigInteger baru dan menetapkannya nilai yang lebih besar dari nilai sebelumnya. Objek baru ini kemudian dikembalikan ke pemanggil.

Nota

Jenis numerik lainnya di .NET juga tidak dapat diubah. Namun, karena jenis BigInteger tidak memiliki batas atas atau bawah, nilainya dapat tumbuh sangat besar dan memiliki dampak yang terukur pada performa.

Meskipun proses ini transparan bagi pemanggil, proses ini menyebabkan penurunan kinerja. Dalam beberapa kasus, terutama ketika operasi berulang dilakukan dalam perulangan pada nilai BigInteger yang sangat besar, penalti performa dapat signifikan. Misalnya, dalam contoh berikut, operasi dilakukan berulang hingga satu juta kali, dan nilai BigInteger bertambah satu kali setiap kali operasi berhasil.

BigInteger number = Int64.MaxValue ^ 5;
int repetitions = 1000000;
// Perform some repetitive operation 1 million times.
for (int ctr = 0; ctr <= repetitions; ctr++)
{
    // Perform some operation. If it fails, exit the loop.
    if (!SomeOperationSucceeds()) break;
    // The following code executes if the operation succeeds.
    number++;
}

Dim number As BigInteger = Int64.MaxValue ^ 5
Dim repetitions As Integer = 1000000
' Perform some repetitive operation 1 million times.
For ctr As Integer = 0 To repetitions
    ' Perform some operation. If it fails, exit the loop.
    If Not SomeOperationSucceeds() Then Exit For
    ' The following code executes if the operation succeeds.
    number += 1
Next

Dalam kasus seperti itu, Anda dapat meningkatkan performa dengan melakukan semua penugasan perantara ke variabel Int32. Nilai akhir variabel kemudian dapat ditetapkan ke objek BigInteger saat perulangan selesai. Contoh berikut memberikan ilustrasi.

BigInteger number = Int64.MaxValue ^ 5;
int repetitions = 1000000;
int actualRepetitions = 0;
// Perform some repetitive operation 1 million times.
for (int ctr = 0; ctr <= repetitions; ctr++)
{
    // Perform some operation. If it fails, exit the loop.
    if (!SomeOperationSucceeds()) break;
    // The following code executes if the operation succeeds.
    actualRepetitions++;
}
number += actualRepetitions;

Dim number As BigInteger = Int64.MaxValue ^ 5
Dim repetitions As Integer = 1000000
Dim actualRepetitions As Integer = 0
' Perform some repetitive operation 1 million times.
For ctr As Integer = 0 To repetitions
    ' Perform some operation. If it fails, exit the loop.
    If Not SomeOperationSucceeds() Then Exit For
    ' The following code executes if the operation succeeds.
    actualRepetitions += 1
Next
number += actualRepetitions

Array byte dan string heksadesimal

Jika Anda mengonversi nilai BigInteger menjadi array byte, atau jika Anda mengonversi array byte menjadi nilai BigInteger, Anda harus mempertimbangkan urutan byte. Struktur BigInteger mengharapkan byte individu dalam array byte muncul dalam urutan little-endian (yaitu, byte dengan urutan lebih rendah dari nilai mendahului byte dengan urutan lebih tinggi). Anda dapat melakukan round-trip nilai BigInteger dengan memanggil metode ToByteArray lalu meneruskan array byte yang dihasilkan ke konstruktor BigInteger(Byte[]), seperti yang ditunjukkan contoh berikut.

BigInteger number = BigInteger.Pow(Int64.MaxValue, 2);
Console.WriteLine(number);

// Write the BigInteger value to a byte array.
byte[] bytes = number.ToByteArray();

// Display the byte array.
foreach (byte byteValue in bytes)
    Console.Write("0x{0:X2} ", byteValue);
Console.WriteLine();

// Restore the BigInteger value from a Byte array.
BigInteger newNumber = new BigInteger(bytes);
Console.WriteLine(newNumber);
// The example displays the following output:
//    8.5070591730234615847396907784E+37
//    0x01 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0x3F
//
//    8.5070591730234615847396907784E+37

Dim number As BigInteger = BigInteger.Pow(Int64.MaxValue, 2)     
Console.WriteLine(number)

' Write the BigInteger value to a byte array.
Dim bytes() As Byte = number.ToByteArray()

' Display the byte array.
For Each byteValue As Byte In bytes
   Console.Write("0x{0:X2} ", byteValue)
Next   
Console.WriteLine()

' Restore the BigInteger value from a Byte array.
Dim newNumber As BigInteger = New BigInteger(bytes)
Console.WriteLine(newNumber)               
' The example displays the following output:
'    8.5070591730234615847396907784E+37
'    0x01 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0x3F
'    
'    8.5070591730234615847396907784E+37

Untuk membuat instans nilai BigInteger dari array byte yang mewakili nilai dari beberapa jenis integral lainnya, Anda dapat meneruskan nilai integral ke metode BitConverter.GetBytes, lalu meneruskan array byte yang dihasilkan ke konstruktor BigInteger(Byte[]). Contoh berikut membuat instans nilai BigInteger dari array byte yang mewakili nilai Int16.

short originalValue = 30000;
Console.WriteLine(originalValue);

// Convert the Int16 value to a byte array.
byte[] bytes = BitConverter.GetBytes(originalValue);

// Display the byte array.
foreach (byte byteValue in bytes)
    Console.Write("0x{0} ", byteValue.ToString("X2"));
Console.WriteLine();

// Pass byte array to the BigInteger constructor.
BigInteger number = new BigInteger(bytes);
Console.WriteLine(number);
// The example displays the following output:
//       30000
//       0x30 0x75
//       30000

Dim originalValue As Short = 30000
Console.WriteLine(originalValue)

' Convert the Int16 value to a byte array.
Dim bytes() As Byte = BitConverter.GetBytes(originalValue)

' Display the byte array.
For Each byteValue As Byte In bytes
   Console.Write("0x{0} ", byteValue.ToString("X2"))
Next    
Console.WriteLine() 

' Pass byte array to the BigInteger constructor.
Dim number As BigInteger = New BigInteger(bytes)
Console.WriteLine(number)
' The example displays the following output:
'       30000
'       0x30 0x75
'       30000

Struktur BigInteger mengasumsikan bahwa nilai negatif disimpan dengan menggunakan representasi pelengkap dua. Karena struktur BigInteger mewakili nilai numerik tanpa panjang tetap, konstruktor BigInteger(Byte[]) selalu menafsirkan bit yang paling signifikan dari byte terakhir dalam array sebagai bit tanda. Untuk mencegah konstruktor BigInteger(Byte[]) membingungkan representasi pelengkap dua nilai negatif dengan tanda dan representasi besar dari nilai positif, nilai positif di mana bit paling signifikan dari byte terakhir dalam array byte biasanya akan ditetapkan harus menyertakan byte tambahan yang nilainya adalah 0. Misalnya, 0xC0 0xBD 0xF0 0xFF adalah representasi heksadesimal little-endian yang bisa menjadi -1.000.000 atau 4.293.967.296. Karena bit yang paling signifikan dari byte terakhir dalam array ini aktif, nilai array byte akan ditafsirkan oleh konstruktor BigInteger(Byte[]) sebagai -1.000.000. Untuk membuat instans BigInteger yang nilainya positif, array byte yang elemennya 0xC0 0xBD 0xF0 0xFF 0x00 harus diteruskan ke konstruktor. Contoh berikut mengilustrasikan hal ini.

int negativeNumber = -1000000;
uint positiveNumber = 4293967296;

byte[] negativeBytes = BitConverter.GetBytes(negativeNumber);
BigInteger negativeBigInt = new BigInteger(negativeBytes);
Console.WriteLine(negativeBigInt.ToString("N0"));

byte[] tempPosBytes = BitConverter.GetBytes(positiveNumber);
byte[] positiveBytes = new byte[tempPosBytes.Length + 1];
Array.Copy(tempPosBytes, positiveBytes, tempPosBytes.Length);
BigInteger positiveBigInt = new BigInteger(positiveBytes);
Console.WriteLine(positiveBigInt.ToString("N0"));
// The example displays the following output:
//    -1,000,000
//    4,293,967,296

Dim negativeNumber As Integer = -1000000
Dim positiveNumber As UInteger = 4293967296

Dim negativeBytes() As Byte = BitConverter.GetBytes(negativeNumber) 
Dim negativeBigInt As New BigInteger(negativeBytes)
Console.WriteLine(negativeBigInt.ToString("N0"))

Dim tempPosBytes() As Byte = BitConverter.GetBytes(positiveNumber)
Dim positiveBytes(tempposBytes.Length) As Byte
Array.Copy(tempPosBytes, positiveBytes, tempPosBytes.Length)
Dim positiveBigInt As New BigInteger(positiveBytes)
Console.WriteLine(positiveBigInt.ToString("N0")) 
' The example displays the following output:
'    -1,000,000
'    4,293,967,296

Array byte yang dibuat oleh metode ToByteArray dari nilai positif menyertakan byte nilai nol tambahan ini. Oleh karena itu, struktur BigInteger dapat berhasil melakukan konversi bolak-balik nilai dengan menetapkannya ke array byte, lalu memulihkannya dari array byte, seperti yang ditunjukkan contoh berikut.

BigInteger positiveValue = 15777216;
BigInteger negativeValue = -1000000;

Console.WriteLine("Positive value: " + positiveValue.ToString("N0"));
byte[] bytes = positiveValue.ToByteArray();

foreach (byte byteValue in bytes)
    Console.Write("{0:X2} ", byteValue);
Console.WriteLine();
positiveValue = new BigInteger(bytes);
Console.WriteLine("Restored positive value: " + positiveValue.ToString("N0"));

Console.WriteLine();

Console.WriteLine("Negative value: " + negativeValue.ToString("N0"));
bytes = negativeValue.ToByteArray();
foreach (byte byteValue in bytes)
    Console.Write("{0:X2} ", byteValue);
Console.WriteLine();
negativeValue = new BigInteger(bytes);
Console.WriteLine("Restored negative value: " + negativeValue.ToString("N0"));
// The example displays the following output:
//       Positive value: 15,777,216
//       C0 BD F0 00
//       Restored positive value: 15,777,216
//
//       Negative value: -1,000,000
//       C0 BD F0
//       Restored negative value: -1,000,000

Dim positiveValue As BigInteger = 15777216
Dim negativeValue As BigInteger = -1000000

Console.WriteLine("Positive value: " + positiveValue.ToString("N0"))
Dim bytes() As Byte = positiveValue.ToByteArray()
For Each byteValue As Byte In bytes
   Console.Write("{0:X2} ", byteValue)
Next
Console.WriteLine()
positiveValue = New BigInteger(bytes)
Console.WriteLine("Restored positive value: " + positiveValue.ToString("N0"))

Console.WriteLine()
   
Console.WriteLIne("Negative value: " + negativeValue.ToString("N0"))
bytes = negativeValue.ToByteArray()
For Each byteValue As Byte In bytes
   Console.Write("{0:X2} ", byteValue)
Next
Console.WriteLine()
negativeValue = New BigInteger(bytes)
Console.WriteLine("Restored negative value: " + negativeValue.ToString("N0"))
' The example displays the following output:
'       Positive value: 15,777,216
'       C0 BD F0 00
'       Restored positive value: 15,777,216
'       
'       Negative value: -1,000,000
'       C0 BD F0
'       Restored negative value: -1,000,000

Namun, Anda mungkin perlu menambahkan byte nilai nol tambahan ini ke array byte yang dibuat secara dinamis oleh pengembang atau yang dikembalikan oleh metode yang mengonversi integer tak bertanda ke array byte (seperti BitConverter.GetBytes(UInt16), BitConverter.GetBytes(UInt32), dan BitConverter.GetBytes(UInt64)).

Saat mengurai string heksadesimal, metode BigInteger.Parse(String, NumberStyles) dan BigInteger.Parse(String, NumberStyles, IFormatProvider) mengasumsikan bahwa jika bit yang paling signifikan dari byte pertama dalam string diatur, atau jika digit heksadesimal pertama dari string mewakili empat bit yang lebih rendah dari nilai byte, nilai diwakili dengan menggunakan representasi pelengkap dua. Misalnya, "FF01" dan "F01" mewakili nilai desimal -255. Untuk membedakan positif dari nilai negatif, nilai positif harus menyertakan nol di depannya. Kelebihan beban yang relevan dari metode ToString, ketika mereka diteruskan string format "X", tambahkan nol di depan ke string heksadesimal yang dikembalikan untuk nilai positif. Ini memungkinkan untuk melakukan round-trip nilai BigInteger dengan menggunakan metode ToString dan Parse, seperti yang ditunjukkan contoh berikut.

BigInteger negativeNumber = -1000000;
BigInteger positiveNumber = 15777216;

string negativeHex = negativeNumber.ToString("X");
string positiveHex = positiveNumber.ToString("X");

BigInteger negativeNumber2, positiveNumber2;
negativeNumber2 = BigInteger.Parse(negativeHex,
                                   NumberStyles.HexNumber);
positiveNumber2 = BigInteger.Parse(positiveHex,
                                   NumberStyles.HexNumber);

Console.WriteLine($"Converted {negativeNumber:N0} to {negativeHex} back to {negativeNumber2:N0}.");
Console.WriteLine($"Converted {positiveNumber:N0} to {positiveHex} back to {positiveNumber2:N0}.");
// The example displays the following output:
//       Converted -1,000,000 to F0BDC0 back to -1,000,000.
//       Converted 15,777,216 to 0F0BDC0 back to 15,777,216.

Dim negativeNumber As BigInteger = -1000000
Dim positiveNumber As BigInteger = 15777216

Dim negativeHex As String = negativeNumber.ToString("X")
Dim positiveHex As string = positiveNumber.ToString("X")

Dim negativeNumber2, positiveNumber2 As BigInteger 
negativeNumber2 = BigInteger.Parse(negativeHex, 
                                   NumberStyles.HexNumber)
positiveNumber2 = BigInteger.Parse(positiveHex,
                                   NumberStyles.HexNumber)

Console.WriteLine("Converted {0:N0} to {1} back to {2:N0}.", 
                   negativeNumber, negativeHex, negativeNumber2)                                         
Console.WriteLine("Converted {0:N0} to {1} back to {2:N0}.", 
                   positiveNumber, positiveHex, positiveNumber2)                                         
' The example displays the following output:
'       Converted -1,000,000 to F0BDC0 back to -1,000,000.
'       Converted 15,777,216 to 0F0BDC0 back to 15,777,216.

Namun, string heksadesimal yang dibuat dengan memanggil metode ToString dari jenis integral lainnya atau kelebihan beban metode ToString yang menyertakan parameter toBase tidak menunjukkan tanda nilai atau jenis data sumber tempat string heksadesimal diturunkan. Berhasil membuat instans nilai BigInteger dari string seperti itu memerlukan beberapa logika tambahan. Contoh berikut memberikan satu kemungkinan implementasi.

using System;
using System.Globalization;
using System.Numerics;

public struct HexValue
{
    public int Sign;
    public string Value;
}

public class ByteHexExample2
{
    public static void Main()
    {
        uint positiveNumber = 4039543321;
        int negativeNumber = -255423975;

        // Convert the numbers to hex strings.
        HexValue hexValue1, hexValue2;
        hexValue1.Value = positiveNumber.ToString("X");
        hexValue1.Sign = Math.Sign(positiveNumber);

        hexValue2.Value = Convert.ToString(negativeNumber, 16);
        hexValue2.Sign = Math.Sign(negativeNumber);

        // Round-trip the hexadecimal values to BigInteger values.
        string hexString;
        BigInteger positiveBigInt, negativeBigInt;

        hexString = (hexValue1.Sign == 1 ? "0" : "") + hexValue1.Value;
        positiveBigInt = BigInteger.Parse(hexString, NumberStyles.HexNumber);
        Console.WriteLine($"Converted {positiveNumber} to {hexValue1.Value} and back to {positiveBigInt}.");

        hexString = (hexValue2.Sign == 1 ? "0" : "") + hexValue2.Value;
        negativeBigInt = BigInteger.Parse(hexString, NumberStyles.HexNumber);
        Console.WriteLine($"Converted {negativeNumber} to {hexValue2.Value} and back to {negativeBigInt}.");
    }
}
// The example displays the following output:
//       Converted 4039543321 to F0C68A19 and back to 4039543321.
//       Converted -255423975 to f0c68a19 and back to -255423975.

Imports System.Globalization
Imports System.Numerics

Public Structure HexValue
    Public Sign As Integer
    Public Value As String
End Structure

Module Example2
    Public Sub Main()
        Dim positiveNumber As UInteger = 4039543321
        Dim negativeNumber As Integer = -255423975

        ' Convert the numbers to hex strings.
        Dim hexValue1, hexValue2 As HexValue
        hexValue1.Value = positiveNumber.ToString("X")
        hexValue1.Sign = Math.Sign(positiveNumber)

        hexValue2.Value = Convert.ToString(negativeNumber, 16)
        hexValue2.Sign = Math.Sign(negativeNumber)

        ' Round-trip the hexadecimal values to BigInteger values.
        Dim hexString As String
        Dim positiveBigInt, negativeBigInt As BigInteger

        hexString = CStr(IIf(hexValue1.Sign = 1, "0", "")) + hexValue1.Value
        positiveBigInt = BigInteger.Parse(hexString, NumberStyles.HexNumber)
        Console.WriteLine("Converted {0} to {1} and back to {2}.",
                        positiveNumber, hexValue1.Value, positiveBigInt)

        hexString = CStr(IIf(hexValue2.Sign = 1, "0", "")) + hexValue2.Value
        negativeBigInt = BigInteger.Parse(hexString, NumberStyles.HexNumber)
        Console.WriteLine("Converted {0} to {1} and back to {2}.",
                        negativeNumber, hexValue2.Value, negativeBigInt)

    End Sub
End Module
' The example displays the following output:
'       Converted 4039543321 to F0C68A19 and back to 4039543321.
'       Converted -255423975 to f0c68a19 and back to -255423975.