System.Byte 구조체

아티클
01/08/2024

이 문서에서는 이 API에 대한 참조 설명서에 대한 추가 설명서를 제공합니다.

Byte 는 0(상수로 표시됨)에서 255(상수로 Byte.MinValue 표현됨)까지의 값을 가진 부호 없는 정수를 나타내는 Byte.MaxValue 변경할 수 없는 값 형식입니다. .NET에는 -128에서 127까지의 값을 나타내는 부가된 8비트 정수 값 형식 SByte도 포함됩니다.

바이트 값 인스턴스화

다음과 같은 Byte 여러 가지 방법으로 값을 인스턴스화할 수 있습니다.

변수를 Byte 선언하고 데이터 형식 범위 내에 있는 리터럴 정수 값을 할당할 Byte 수 있습니다. 다음 예제에서는 두 Byte 변수를 선언하고 이러한 방식으로 값을 할당합니다.
```
byte value1 = 64;
byte value2 = 255;
```
```
let value1 = 64uy
let value2 = 255uy
```
```
Dim value1 As Byte = 64
Dim value2 As Byte = 255
```

바이트가 아닌 숫자 값을 바이트에 할당할 수 있습니다. 축소 변환이므로 C# 및 F#의 캐스트 연산자 또는 Visual Basic의 변환 메서드(있는 경우 Option Strict )가 필요합니다. 비바이트 값이 Single Double소수 구성 요소를 포함하는 값 또는 Decimal 값인 경우 해당 소수 부분의 처리는 변환을 수행하는 컴파일러에 따라 달라집니다. 다음 예제에서는 여러 숫자 값을 변수에 Byte 할당합니다.

int int1 = 128;
try
{
    byte value1 = (byte)int1;
    Console.WriteLine(value1);
}
catch (OverflowException)
{
    Console.WriteLine("{0} is out of range of a byte.", int1);
}

double dbl2 = 3.997;
try
{
    byte value2 = (byte)dbl2;
    Console.WriteLine(value2);
}
catch (OverflowException)
{
    Console.WriteLine("{0} is out of range of a byte.", dbl2);
}
// The example displays the following output:
//       128
//       3

let int1 = 128
try
    let value1 = byte int1
    printfn $"{value1}"
with :? OverflowException ->
    printfn $"{int1} is out of range of a byte."

let dbl2 = 3.997
try
    let value2 = byte dbl2
    printfn $"{value2}"
with :? OverflowException ->
    printfn $"{dbl2} is out of range of a byte."

// The example displays the following output:
//       128
//       3

Dim int1 As Integer = 128
Try
    Dim value1 As Byte = CByte(int1)
    Console.WriteLine(value1)
Catch e As OverflowException
    Console.WriteLine("{0} is out of range of a byte.", int1)
End Try

Dim dbl2 As Double = 3.997
Try
    Dim value2 As Byte = CByte(dbl2)
    Console.WriteLine(value2)
Catch e As OverflowException
    Console.WriteLine("{0} is out of range of a byte.", dbl2)
End Try
' The example displays the following output:
'       128
'       4

클래스의 Convert 메서드를 호출하여 지원되는 모든 형식을 값으로 Byte 변환할 수 있습니다. 인터페이스를 IConvertible 지원하기 때문에 Byte 가능합니다. 다음 예제에서는 값 배열 Int32 을 값으로 변환하는 방법을 Byte 보여 줍니다.

int[] numbers = { Int32.MinValue, -1, 0, 121, 340, Int32.MaxValue };
byte result;
foreach (int number in numbers)
{
    try
    {
        result = Convert.ToByte(number);
        Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                          number.GetType().Name, number,
                          result.GetType().Name, result);
    }
    catch (OverflowException)
    {
        Console.WriteLine("The {0} value {1} is outside the range of the Byte type.",
                          number.GetType().Name, number);
    }
}
// The example displays the following output:
//       The Int32 value -2147483648 is outside the range of the Byte type.
//       The Int32 value -1 is outside the range of the Byte type.
//       Converted the Int32 value 0 to the Byte value 0.
//       Converted the Int32 value 121 to the Byte value 121.
//       The Int32 value 340 is outside the range of the Byte type.
//       The Int32 value 2147483647 is outside the range of the Byte type.

let numbers = [| Int32.MinValue; -1; 0; 121; 340; Int32.MaxValue |]
for number in numbers do
    try
        let result = Convert.ToByte number
        printfn $"Converted the {number.GetType().Name} value {number} to the {result.GetType().Name} value {result}."
    with :? OverflowException ->
        printfn $"The {number.GetType().Name} value {number} is outside the range of the Byte type."
// The example displays the following output:
//       The Int32 value -2147483648 is outside the range of the Byte type.
//       The Int32 value -1 is outside the range of the Byte type.
//       Converted the Int32 value 0 to the Byte value 0.
//       Converted the Int32 value 121 to the Byte value 121.
//       The Int32 value 340 is outside the range of the Byte type.
//       The Int32 value 2147483647 is outside the range of the Byte type.

Dim numbers() As Integer = {Int32.MinValue, -1, 0, 121, 340, Int32.MaxValue}
Dim result As Byte
For Each number As Integer In numbers
    Try
        result = Convert.ToByte(number)
        Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                      number.GetType().Name, number,
                      result.GetType().Name, result)
    Catch e As OverflowException
        Console.WriteLine("The {0} value {1} is outside the range of the Byte type.",
                      number.GetType().Name, number)
    End Try
Next
' The example displays the following output:
'       The Int32 value -2147483648 is outside the range of the Byte type.
'       The Int32 value -1 is outside the range of the Byte type.
'       Converted the Int32 value 0 to the Byte value 0.
'       Converted the Int32 value 121 to the Byte value 121.
'       The Int32 value 340 is outside the range of the Byte type.
'       The Int32 value 2147483647 is outside the range of the Byte type.

또는 메서드를 Parse 호출하여 값의 문자열 표현을 Byte .로 Byte변환할 수 TryParse 있습니다. 문자열은 10진수 또는 16진수를 포함할 수 있습니다. 다음 예제에서는 10진수 및 16진수 문자열을 모두 사용하여 구문 분석 작업을 보여 줍니다.

string string1 = "244";
try
{
    byte byte1 = Byte.Parse(string1);
    Console.WriteLine(byte1);
}
catch (OverflowException)
{
    Console.WriteLine("'{0}' is out of range of a byte.", string1);
}
catch (FormatException)
{
    Console.WriteLine("'{0}' is out of range of a byte.", string1);
}

string string2 = "F9";
try
{
    byte byte2 = Byte.Parse(string2,
                            System.Globalization.NumberStyles.HexNumber);
    Console.WriteLine(byte2);
}
catch (OverflowException)
{
    Console.WriteLine("'{0}' is out of range of a byte.", string2);
}
catch (FormatException)
{
    Console.WriteLine("'{0}' is out of range of a byte.", string2);
}
// The example displays the following output:
//       244
//       249

let string1 = "244"
try
    let byte1 = Byte.Parse string1
    printfn $"{byte1}" 
with
| :? OverflowException ->
    printfn $"'{string1}' is out of range of a byte."
| :? FormatException ->
    printfn $"'{string1}' is out of range of a byte."

let string2 = "F9"
try
    let byte2 = Byte.Parse(string2, System.Globalization.NumberStyles.HexNumber)
    printfn $"{byte2}"
with
| :? OverflowException ->
    printfn $"'{string2}' is out of range of a byte."
| :? FormatException ->
    printfn $"'{string2}' is out of range of a byte."

// The example displays the following output:
//       244
//       249

Dim string1 As String = "244"
Try
    Dim byte1 As Byte = Byte.Parse(string1)
    Console.WriteLine(byte1)
Catch e As OverflowException
    Console.WriteLine("'{0}' is out of range of a byte.", string1)
Catch e As FormatException
    Console.WriteLine("'{0}' is out of range of a byte.", string1)
End Try

Dim string2 As String = "F9"
Try
    Dim byte2 As Byte = Byte.Parse(string2,
                           System.Globalization.NumberStyles.HexNumber)
    Console.WriteLine(byte2)
Catch e As OverflowException
    Console.WriteLine("'{0}' is out of range of a byte.", string2)
Catch e As FormatException
    Console.WriteLine("'{0}' is out of range of a byte.", string2)
End Try
' The example displays the following output:
'       244
'       249

바이트 값에 대한 작업 수행

이 형식은 Byte 더하기, 빼기, 나누기, 곱하기, 빼기, 부정 및 단항 부정과 같은 표준 수학 연산을 지원합니다. 다른 정수 계열 형식 Byte 과 마찬가지로 이 형식은 비트 AND, OR왼쪽 XOR시프트 및 오른쪽 시프트 연산자도 지원합니다.

표준 숫자 연산자를 사용하여 두 Byte 값을 비교하거나 또는 Equals 메서드를 호출할 CompareTo 수 있습니다.

또한 클래스의 Math 멤버를 호출하여 숫자의 절대값 가져오기, 정수 구분에서 몫 및 다시 계산기본der, 두 정수의 최대값 또는 최소값 결정, 숫자 부호 가져오기, 숫자 반올림 등 다양한 숫자 연산을 수행할 수 있습니다.

바이트를 문자열로 표현

이 형식은 Byte 표준 및 사용자 지정 숫자 형식 문자열을 완전히 지원합니다. (자세한 내용은 를 참조하세요 .형식, 표준 숫자 형식 문자열 및 사용자 지정 숫자 형식 문자열을 지정합니다.) 그러나 가장 일반적으로 바이트 값은 추가 서식 없이 1자리에서 3자리 값으로 표현되거나 두 자리 16진수 값으로 표시됩니다.

앞에 오는 Byte 0이 없는 정수 문자열로 값의 서식을 지정하려면 매개 변수가 없는 ToString() 메서드를 호출할 수 있습니다. "D" 형식 지정자를 사용하여 문자열 표현에 지정된 수의 선행 0을 포함할 수도 있습니다. "X" 형식 지정자를 사용하여 값을 16진수 문자열로 나타낼 Byte 수 있습니다. 다음 예제에서는 이러한 세 가지 방법으로 값 배열의 Byte 요소 형식을 지정합니다.

byte[] numbers = { 0, 16, 104, 213 };
foreach (byte number in numbers)
{
    // Display value using default formatting.
    Console.Write("{0,-3}  -->   ", number.ToString());
    // Display value with 3 digits and leading zeros.
    Console.Write(number.ToString("D3") + "   ");
    // Display value with hexadecimal.
    Console.Write(number.ToString("X2") + "   ");
    // Display value with four hexadecimal digits.
    Console.WriteLine(number.ToString("X4"));
}
// The example displays the following output:
//       0    -->   000   00   0000
//       16   -->   016   10   0010
//       104  -->   104   68   0068
//       213  -->   213   D5   00D5

let numbers = [| 0; 16; 104; 213 |]
for number in numbers do
    // Display value using default formatting.
    number.ToString()
    |> printf "%-3s  -->   "

    // Display value with 3 digits and leading zeros.
    number.ToString "D3"
    |> printf "%s   "
    
    // Display value with hexadecimal.
    number.ToString "X2"
    |> printf "%s   "
    
    // Display value with four hexadecimal digits.
    number.ToString "X4"
    |> printfn "%s"

// The example displays the following output:
//       0    -->   000   00   0000
//       16   -->   016   10   0010
//       104  -->   104   68   0068
//       213  -->   213   D5   00D5

Dim numbers() As Byte = {0, 16, 104, 213}
For Each number As Byte In numbers
    ' Display value using default formatting.
    Console.Write("{0,-3}  -->   ", number.ToString())
    ' Display value with 3 digits and leading zeros.
    Console.Write(number.ToString("D3") + "   ")
    ' Display value with hexadecimal.
    Console.Write(number.ToString("X2") + "   ")
    ' Display value with four hexadecimal digits.
    Console.WriteLine(number.ToString("X4"))
Next
' The example displays the following output:
'       0    -->   000   00   0000
'       16   -->   016   10   0010
'       104  -->   104   68   0068
'       213  -->   213   D5   00D5

메서드를 호출 ToString(Byte, Int32) 하고 밑을 Byte 메서드의 두 번째 매개 변수로 제공하여 값을 이진, 8진수, 10진수 또는 16진수 문자열로 서식을 지정할 수도 있습니다. 다음 예제에서는 바이트 값 배열의 이진, 8진수 및 16진수 표현을 표시하기 위해 이 메서드를 호출합니다.

byte[] numbers = { 0, 16, 104, 213 };
Console.WriteLine("{0}   {1,8}   {2,5}   {3,5}",
                  "Value", "Binary", "Octal", "Hex");
foreach (byte number in numbers)
{
    Console.WriteLine("{0,5}   {1,8}   {2,5}   {3,5}",
                      number, Convert.ToString(number, 2),
                      Convert.ToString(number, 8),
                      Convert.ToString(number, 16));
}
// The example displays the following output:
//       Value     Binary   Octal     Hex
//           0          0       0       0
//          16      10000      20      10
//         104    1101000     150      68
//         213   11010101     325      d5

let numbers = [| 0; 16; 104; 213 |]
printfn "%s   %8s   %5s   %5s" "Value" "Binary" "Octal" "Hex"
for number in numbers do
    printfn $"%5i{number}   %8s{Convert.ToString(number, 2)}   %5s{Convert.ToString(number, 8)}   %5s{Convert.ToString(number, 16)}"
                    
// The example displays the following output:
//       Value     Binary   Octal     Hex
//           0          0       0       0
//          16      10000      20      10
//         104    1101000     150      68
//         213   11010101     325      d5

Dim numbers() As Byte = {0, 16, 104, 213}
Console.WriteLine("{0}   {1,8}   {2,5}   {3,5}",
                "Value", "Binary", "Octal", "Hex")
For Each number As Byte In numbers
    Console.WriteLine("{0,5}   {1,8}   {2,5}   {3,5}",
                   number, Convert.ToString(number, 2),
                   Convert.ToString(number, 8),
                   Convert.ToString(number, 16))
Next
' The example displays the following output:
'       Value     Binary   Octal     Hex
'           0          0       0       0
'          16      10000      20      10
'         104    1101000     150      68
'         213   11010101     325      d5

10진수가 아닌 바이트 값 사용

개별 바이트를 10진수 값으로 사용하는 것 외에도 바이트 값을 사용하여 비트 연산을 수행하거나 바이트 배열 또는 바이트 값의 이진 또는 16진수 표현으로 작업할 수 있습니다. 예를 들어 메서드의 BitConverter.GetBytes 오버로드는 각 기본 데이터 형식을 바이트 배열로 변환할 수 있으며 메서드는 BigInteger.ToByteArray 값을 바이트 배열로 변환합니다 BigInteger .

Byte 값은 부호 비트 없이 크기로만 8비트로 표시됩니다. 이는 값에 대해 Byte 비트 연산을 수행하거나 개별 비트로 작업할 때 유의해야 합니다. 소수점이 아닌 두 값에 대해 숫자, 부울 또는 비교 작업을 수행하려면 두 값 모두 동일한 표현을 사용해야 합니다.

두 Byte 값에 대해 작업을 수행하는 경우 값은 동일한 표현을 공유하므로 결과가 정확합니다. 다음 예제에서는 값의 Byte 가장 낮은 순서 비트를 마스킹하여 짝수인지 확인합니다.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] values = { Convert.ToString(12, 16),
                          Convert.ToString(123, 16),
                          Convert.ToString(245, 16) };

      byte mask = 0xFE;
      foreach (string value in values) {
         Byte byteValue = Byte.Parse(value, NumberStyles.AllowHexSpecifier);
         Console.WriteLine("{0} And {1} = {2}", byteValue, mask,
                           byteValue & mask);
      }
   }
}
// The example displays the following output:
//       12 And 254 = 12
//       123 And 254 = 122
//       245 And 254 = 244

open System
open System.Globalization

let values = 
    [ Convert.ToString(12, 16)
      Convert.ToString(123, 16)
      Convert.ToString(245, 16) ]

let mask = 0xFEuy
for value in values do
    let byteValue = Byte.Parse(value, NumberStyles.AllowHexSpecifier)
    printfn $"{byteValue} And {mask} = {byteValue &&& mask}"
                    

// The example displays the following output:
//       12 And 254 = 12
//       123 And 254 = 122
//       245 And 254 = 244

Imports System.Globalization

Module Example1
    Public Sub Main()
        Dim values() As String = {Convert.ToString(12, 16),
                                 Convert.ToString(123, 16),
                                 Convert.ToString(245, 16)}

        Dim mask As Byte = &HFE
        For Each value As String In values
            Dim byteValue As Byte = Byte.Parse(value, NumberStyles.AllowHexSpecifier)
            Console.WriteLine("{0} And {1} = {2}", byteValue, mask,
                           byteValue And mask)
        Next
    End Sub
End Module
' The example displays the following output:
'       12 And 254 = 12
'       123 And 254 = 122
'       245 And 254 = 244

반면에 부호 없는 비트와 부호 있는 비트를 모두 사용하는 경우 비트 연산은 값이 양수 값에 대해 부호 및 진도 표현을 사용하고 음수 값에 대해 두 개의 보수 표현을 사용한다는 SByte 사실 때문에 복잡합니다. 의미 있는 비트 연산을 수행하려면 값을 두 개의 동등한 표현으로 변환해야 하며 부호 비트에 대한 정보는 보존되어야 합니다. 다음 예제에서는 부호 있는 8비트 및 부호 없는 값 배열의 비트 2와 4를 마스킹합니다.

using System;
using System.Collections.Generic;
using System.Globalization;

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

public class Example1
{
    public static void Main()
    {
        ByteString[] values = CreateArray(-15, 123, 245);

        byte mask = 0x14;        // Mask all bits but 2 and 4.

        foreach (ByteString strValue in values)
        {
            byte byteValue = Byte.Parse(strValue.Value, NumberStyles.AllowHexSpecifier);
            Console.WriteLine("{0} ({1}) And {2} ({3}) = {4} ({5})",
                              strValue.Sign * byteValue,
                              Convert.ToString(byteValue, 2),
                              mask, Convert.ToString(mask, 2),
                              (strValue.Sign & Math.Sign(mask)) * (byteValue & mask),
                              Convert.ToString(byteValue & mask, 2));
        }
    }

    private static ByteString[] CreateArray(params int[] values)
    {
        List<ByteString> byteStrings = new List<ByteString>();

        foreach (object value in values)
        {
            ByteString temp = new ByteString();
            int sign = Math.Sign((int)value);
            temp.Sign = sign;

            // Change two's complement to magnitude-only representation.
            temp.Value = Convert.ToString(((int)value) * sign, 16);

            byteStrings.Add(temp);
        }
        return byteStrings.ToArray();
    }
}
// The example displays the following output:
//       -15 (1111) And 20 (10100) = 4 (100)
//       123 (1111011) And 20 (10100) = 16 (10000)
//       245 (11110101) And 20 (10100) = 20 (10100)

open System
open System.Collections.Generic
open System.Globalization

[<Struct>]
type ByteString =
    { Sign: int
      Value: string }

let createArray values =
    [ for value in values do
        let sign = sign value
        { Sign = sign
         // Change two's complement to magnitude-only representation.
          Value = Convert.ToString(value * sign, 16)} ]


let values = createArray [ -15; 123; 245 ]

let mask = 0x14uy        // Mask all bits but 2 and 4.

for strValue in values do
    let byteValue = Byte.Parse(strValue.Value, NumberStyles.AllowHexSpecifier)
    printfn $"{strValue.Sign * int byteValue} ({Convert.ToString(byteValue, 2)}) And {mask} ({Convert.ToString(mask, 2)}) = {(strValue.Sign &&& (int mask |> sign)) * int (byteValue &&& mask)} ({Convert.ToString(byteValue &&& mask, 2)})"

// The example displays the following output:
//       -15 (1111) And 20 (10100) = 4 (100)
//       123 (1111011) And 20 (10100) = 16 (10000)
//       245 (11110101) And 20 (10100) = 20 (10100)

Imports System.Collections.Generic
Imports System.Globalization

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

Module Example2
    Public Sub Main()
        Dim values() As ByteString = CreateArray(-15, 123, 245)

        Dim mask As Byte = &H14        ' Mask all bits but 2 and 4.

        For Each strValue As ByteString In values
            Dim byteValue As Byte = Byte.Parse(strValue.Value, NumberStyles.AllowHexSpecifier)
            Console.WriteLine("{0} ({1}) And {2} ({3}) = {4} ({5})",
                           strValue.Sign * byteValue,
                           Convert.ToString(byteValue, 2),
                           mask, Convert.ToString(mask, 2),
                           (strValue.Sign And Math.Sign(mask)) * (byteValue And mask),
                           Convert.ToString(byteValue And mask, 2))
        Next
    End Sub

    Private Function CreateArray(ParamArray values() As Object) As ByteString()
        Dim byteStrings As New List(Of ByteString)
        For Each value As Object In values
            Dim temp As New ByteString()
            Dim sign As Integer = Math.Sign(value)
            temp.Sign = sign
            ' Change two's complement to magnitude-only representation.
            value = value * sign

            temp.Value = Convert.ToString(value, 16)
            byteStrings.Add(temp)
        Next
        Return byteStrings.ToArray()
    End Function
End Module
' The example displays the following output:
'       -15 (1111) And 20 (10100) = 4 (100)
'       123 (1111011) And 20 (10100) = 16 (10000)
'       245 (11110101) And 20 (10100) = 20 (10100)

다음을 통해 공유

System.Byte 구조체

바이트 값 인스턴스화

바이트 값에 대한 작업 수행

바이트를 문자열로 표현

10진수가 아닌 바이트 값 사용

추가 리소스