Char 구조체

정의

UTF-16 코드 단위인 문자를 나타냅니다.

public value class char : IComparable, IComparable<char>, IConvertible, IEquatable<char>
public value class char : IComparable, IComparable<char>, IConvertible, IEquatable<char>, ISpanFormattable
public value class char : IAdditionOperators<char, char, char>, IAdditiveIdentity<char, char>, IBinaryInteger<char>, IBinaryNumber<char>, IBitwiseOperators<char, char, char>, IComparable<char>, IComparisonOperators<char, char>, IConvertible, IDecrementOperators<char>, IDivisionOperators<char, char, char>, IEqualityOperators<char, char>, IEquatable<char>, IIncrementOperators<char>, IMinMaxValue<char>, IModulusOperators<char, char, char>, IMultiplicativeIdentity<char, char>, IMultiplyOperators<char, char, char>, INumber<char>, IParseable<char>, IShiftOperators<char, char>, ISpanParseable<char>, ISubtractionOperators<char, char, char>, IUnaryNegationOperators<char, char>, IUnaryPlusOperators<char, char>, IUnsignedNumber<char>
public value class char : IComparable, IConvertible
public value class char : IComparable, IComparable<char>, IEquatable<char>
public struct Char : IComparable, IComparable<char>, IConvertible, IEquatable<char>
public readonly struct Char : IComparable, IComparable<char>, IConvertible, IEquatable<char>
public readonly struct Char : IComparable, IComparable<char>, IConvertible, IEquatable<char>, ISpanFormattable
public readonly struct Char : IAdditionOperators<char,char,char>, IAdditiveIdentity<char,char>, IBinaryInteger<char>, IBinaryNumber<char>, IBitwiseOperators<char,char,char>, IComparable<char>, IComparisonOperators<char,char>, IConvertible, IDecrementOperators<char>, IDivisionOperators<char,char,char>, IEqualityOperators<char,char>, IEquatable<char>, IIncrementOperators<char>, IMinMaxValue<char>, IModulusOperators<char,char,char>, IMultiplicativeIdentity<char,char>, IMultiplyOperators<char,char,char>, INumber<char>, IParseable<char>, IShiftOperators<char,char>, ISpanParseable<char>, ISubtractionOperators<char,char,char>, IUnaryNegationOperators<char,char>, IUnaryPlusOperators<char,char>, IUnsignedNumber<char>
[System.Serializable]
public struct Char : IComparable, IConvertible
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public struct Char : IComparable, IComparable<char>, IConvertible, IEquatable<char>
public struct Char : IComparable, IComparable<char>, IEquatable<char>
type char = struct
    interface IConvertible
type char = struct
    interface IConvertible
    interface ISpanFormattable
    interface IFormattable
type char = struct
    interface IConvertible
    interface ISpanFormattable
    interface IFormattable
    interface IBinaryInteger<char>
    interface IBinaryNumber<char>
    interface IBitwiseOperators<char, char, char>
    interface INumber<char>
    interface IAdditionOperators<char, char, char>
    interface IAdditiveIdentity<char, char>
    interface IComparisonOperators<char, char>
    interface IEqualityOperators<char, char>
    interface IDecrementOperators<char>
    interface IDivisionOperators<char, char, char>
    interface IIncrementOperators<char>
    interface IModulusOperators<char, char, char>
    interface IMultiplicativeIdentity<char, char>
    interface IMultiplyOperators<char, char, char>
    interface IParseable<char>
    interface ISpanParseable<char>
    interface ISubtractionOperators<char, char, char>
    interface IUnaryNegationOperators<char, char>
    interface IUnaryPlusOperators<char, char>
    interface IShiftOperators<char, char>
    interface IMinMaxValue<char>
    interface IUnsignedNumber<char>
[<System.Serializable>]
type char = struct
    interface IConvertible
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type char = struct
    interface IConvertible
type char = struct
Public Structure Char
Implements IComparable, IComparable(Of Char), IConvertible, IEquatable(Of Char)
Public Structure Char
Implements IComparable, IComparable(Of Char), IConvertible, IEquatable(Of Char), ISpanFormattable
Public Structure Char
Implements IAdditionOperators(Of Char, Char, Char), IAdditiveIdentity(Of Char, Char), IBinaryInteger(Of Char), IBinaryNumber(Of Char), IBitwiseOperators(Of Char, Char, Char), IComparable(Of Char), IComparisonOperators(Of Char, Char), IConvertible, IDecrementOperators(Of Char), IDivisionOperators(Of Char, Char, Char), IEqualityOperators(Of Char, Char), IEquatable(Of Char), IIncrementOperators(Of Char), IMinMaxValue(Of Char), IModulusOperators(Of Char, Char, Char), IMultiplicativeIdentity(Of Char, Char), IMultiplyOperators(Of Char, Char, Char), INumber(Of Char), IParseable(Of Char), IShiftOperators(Of Char, Char), ISpanParseable(Of Char), ISubtractionOperators(Of Char, Char, Char), IUnaryNegationOperators(Of Char, Char), IUnaryPlusOperators(Of Char, Char), IUnsignedNumber(Of Char)
Public Structure Char
Implements IComparable, IConvertible
Public Structure Char
Implements IComparable, IComparable(Of Char), IEquatable(Of Char)
상속
특성
구현

예제

다음 코드 예제에서는 .의 일부 메서드를 Char보여 줍니다.

using namespace System;
int main()
{
   char chA = 'A';
   char ch1 = '1';
   String^ str =  "test string";
   Console::WriteLine( chA.CompareTo( 'B' ) ); // Output: "-1" (meaning 'A' is 1 less than 'B')
   Console::WriteLine( chA.Equals( 'A' ) ); // Output: "True"
   Console::WriteLine( Char::GetNumericValue( ch1 ) ); // Output: "1"
   Console::WriteLine( Char::IsControl( '\t' ) ); // Output: "True"
   Console::WriteLine( Char::IsDigit( ch1 ) ); // Output: "True"
   Console::WriteLine( Char::IsLetter( ',' ) ); // Output: "False"
   Console::WriteLine( Char::IsLower( 'u' ) ); // Output: "True"
   Console::WriteLine( Char::IsNumber( ch1 ) ); // Output: "True"
   Console::WriteLine( Char::IsPunctuation( '.' ) ); // Output: "True"
   Console::WriteLine( Char::IsSeparator( str, 4 ) ); // Output: "True"
   Console::WriteLine( Char::IsSymbol( '+' ) ); // Output: "True"
   Console::WriteLine( Char::IsWhiteSpace( str, 4 ) ); // Output: "True"
   Console::WriteLine( Char::Parse(  "S" ) ); // Output: "S"
   Console::WriteLine( Char::ToLower( 'M' ) ); // Output: "m"
   Console::WriteLine( 'x' ); // Output: "x"
}
using System;

public class CharStructureSample
{
    public static void Main()
    {
        char chA = 'A';
        char ch1 = '1';
        string str = "test string";

        Console.WriteLine(chA.CompareTo('B'));          //-----------  Output: "-1" (meaning 'A' is 1 less than 'B')
        Console.WriteLine(chA.Equals('A'));             //-----------  Output: "True"
        Console.WriteLine(Char.GetNumericValue(ch1));   //-----------  Output: "1"
        Console.WriteLine(Char.IsControl('\t'));        //-----------  Output: "True"
        Console.WriteLine(Char.IsDigit(ch1));           //-----------  Output: "True"
        Console.WriteLine(Char.IsLetter(','));          //-----------  Output: "False"
        Console.WriteLine(Char.IsLower('u'));           //-----------  Output: "True"
        Console.WriteLine(Char.IsNumber(ch1));          //-----------  Output: "True"
        Console.WriteLine(Char.IsPunctuation('.'));     //-----------  Output: "True"
        Console.WriteLine(Char.IsSeparator(str, 4));    //-----------  Output: "True"
        Console.WriteLine(Char.IsSymbol('+'));          //-----------  Output: "True"
        Console.WriteLine(Char.IsWhiteSpace(str, 4));   //-----------  Output: "True"
        Console.WriteLine(Char.Parse("S"));             //-----------  Output: "S"
        Console.WriteLine(Char.ToLower('M'));           //-----------  Output: "m"
        Console.WriteLine('x'.ToString());              //-----------  Output: "x"
    }
}
open System

let chA = 'A'
let ch1 = '1'
let str = "test string"

printfn $"{chA.CompareTo 'B'}"          //-----------  Output: "-1" (meaning 'A' is 1 less than 'B')
printfn $"{chA.Equals 'A'}"             //-----------  Output: "True"
printfn $"{Char.GetNumericValue ch1}"   //-----------  Output: "1"
printfn $"{Char.IsControl '\t'}"        //-----------  Output: "True"
printfn $"{Char.IsDigit ch1}"           //-----------  Output: "True"
printfn $"{Char.IsLetter ','}"          //-----------  Output: "False"
printfn $"{Char.IsLower 'u'}"           //-----------  Output: "True"
printfn $"{Char.IsNumber ch1}"          //-----------  Output: "True"
printfn $"{Char.IsPunctuation '.'}"     //-----------  Output: "True"
printfn $"{Char.IsSeparator(str, 4)}"   //-----------  Output: "True"
printfn $"{Char.IsSymbol '+'}"          //-----------  Output: "True"
printfn $"{Char.IsWhiteSpace(str, 4)}"  //-----------  Output: "True"
printfn $"""{Char.Parse "S"}"""         //-----------  Output: "S"
printfn $"{Char.ToLower 'M'}"           //-----------  Output: "m"
printfn $"{'x'}"                        //-----------  Output: "x"
Module CharStructure

    Public Sub Main()

        Dim chA As Char
        chA = "A"c
        Dim ch1 As Char
        ch1 = "1"c
        Dim str As String
        str = "test string"

        Console.WriteLine(chA.CompareTo("B"c))          ' Output: "-1" (meaning 'A' is 1 less than 'B')
        Console.WriteLine(chA.Equals("A"c))             ' Output: "True"
        Console.WriteLine(Char.GetNumericValue(ch1))    ' Output: "1"
        Console.WriteLine(Char.IsControl(Chr(9)))       ' Output: "True"
        Console.WriteLine(Char.IsDigit(ch1))            ' Output: "True"
        Console.WriteLine(Char.IsLetter(","c))          ' Output: "False"
        Console.WriteLine(Char.IsLower("u"c))           ' Output: "True"
        Console.WriteLine(Char.IsNumber(ch1))           ' Output: "True"
        Console.WriteLine(Char.IsPunctuation("."c))     ' Output: "True"
        Console.WriteLine(Char.IsSeparator(str, 4))     ' Output: "True"
        Console.WriteLine(Char.IsSymbol("+"c))          ' Output: "True"
        Console.WriteLine(Char.IsWhiteSpace(str, 4))    ' Output: "True"
        Console.WriteLine(Char.Parse("S"))              ' Output: "S"
        Console.WriteLine(Char.ToLower("M"c))           ' Output: "m"
        Console.WriteLine("x"c.ToString())              ' Output: "x"

    End Sub

End Module

설명

.NET은 구조체를 Char 사용하여 UTF-16 인코딩을 사용하여 유니코드 코드 포인트를 나타냅니다. 개체의 Char 값은 16비트 숫자(서수) 값입니다.

유니코드, 스칼라 값, 코드 포인트, 서로게이트 쌍, UTF-16 및 Rune 형식에 익숙하지 않은 경우 .NET의 문자 인코딩 소개를 참조하세요.

다음 섹션에서는 개체와 문자 간의 Char 관계를 살펴보고 인스턴스에서 수행되는 Char 몇 가지 일반적인 작업에 대해 설명합니다. 이러한 작업 중 일부를 수행하기 위한 대안으로 .NET Core 3.0에 도입된 형식을 Char 고려하는 Rune 것이 좋습니다.

Char 개체, 유니코드 문자 및 문자열

String 개체는 텍스트 문자열을 나타내는 구조체의 Char 순차적 컬렉션입니다. 대부분의 유니코드 문자는 단일 Char 개체로 나타낼 수 있지만 기본 문자, 서로게이트 쌍 및/또는 결합 문자 시퀀스로 인코딩된 문자는 여러 Char 개체로 표시됩니다. 따라서 개체의 Char 구조 String 체가 반드시 단일 유니코드 문자와 동일한 것은 아닙니다.

여러 16비트 코드 단위는 다음과 같은 경우 단일 유니코드 문자를 나타내는 데 사용됩니다.

  • 문자 모양- 단일 문자 또는 기본 문자와 하나 이상의 결합 문자로 구성될 수 있습니다. 예를 들어 ä 문자는 코드 단위가 U+0061인 개체와 Char 코드 단위가 U+0308인 개체로 표시됩니다Char. (U+00E4의 코드 단위가 있는 단일 Char 개체에서 문자 ä를 정의할 수도 있습니다.) 다음 예제에서는 ä 문자가 두 Char 개체로 구성되어 있음을 보여 줍니다.

    using System;
    using System.IO;
    
    public class Example
    {
       public static void Main()
       {
          StreamWriter sw = new StreamWriter("chars1.txt");
          char[] chars = { '\u0061', '\u0308' };
          string strng = new String(chars);
          sw.WriteLine(strng);
          sw.Close();
       }
    }
    // The example produces the following output:
    //       ä
    
    open System
    open System.IO
    
    let sw = new StreamWriter("chars1.txt")
    let chars = [| '\u0061'; '\u0308' |]
    let string = String chars
    sw.WriteLine string
    sw.Close()
    
    // The example produces the following output:
    //       ä
    
    Imports System.IO
    
    Module Example
       Public Sub Main()
          Dim sw As New StreamWriter("chars1.txt")
          Dim chars() As Char = { ChrW(&h0061), ChrW(&h0308) }
          Dim strng As New String(chars)
          sw.WriteLine(strng) 
          sw.Close()
       End Sub
    End Module
    ' The example produces the following output:
    '       ä
    
  • 유니코드 기본 BMP(다국어 평면) 외부의 문자입니다. 유니코드는 평면 0을 나타내는 BMP 외에도 16개의 평면을 지원합니다. 유니코드 코드 포인트는 평면을 포함하는 21비트 값으로 UTF-32로 표시됩니다. 예를 들어 U+1D160은 MUSICAL SYMBOL EIGHTH NOTE 문자를 나타냅니다. UTF-16 인코딩에는 16비트만 있으므로 BMP 외부의 문자는 UTF-16의 서로게이트 쌍으로 표시됩니다. 다음 예제에서는 U+1D160에 해당하는 UTF-32, MUSICAL SYMBOL EIGHTH NOTE 문자가 U+D834 U+DD60임을 보여 줍니다. U+D834는 상위 서로게이트입니다. 상위 서로게이트 범위는 U+D800부터 U+DBFF까지입니다. U+DD60은 하위 서로게이트입니다. 하위 서로게이트 범위는 U+DC00부터 U+DFFF까지입니다.

    using System;
    using System.IO;
    
    public class Example
    {
       public static void Main()
       {
          StreamWriter sw = new StreamWriter(@".\chars2.txt");
          int utf32 = 0x1D160;
          string surrogate = Char.ConvertFromUtf32(utf32);
          sw.WriteLine("U+{0:X6} UTF-32 = {1} ({2}) UTF-16",
                       utf32, surrogate, ShowCodePoints(surrogate));
          sw.Close();
       }
    
       private static string ShowCodePoints(string value)
       {
          string retval = null;
          foreach (var ch in value)
             retval += String.Format("U+{0:X4} ", Convert.ToUInt16(ch));
    
          return retval.Trim();
       }
    }
    // The example produces the following output:
    //       U+01D160 UTF-32 = ð (U+D834 U+DD60) UTF-16
    
    open System
    open System.IO
    
    let showCodePoints (value: char seq) =
        let str =
            value
            |> Seq.map (fun ch -> $"U+{Convert.ToUInt16 ch:X4}")
            |> String.concat ""
        str.Trim()
    
    let sw = new StreamWriter(@".\chars2.txt")
    let utf32 = 0x1D160
    let surrogate = Char.ConvertFromUtf32 utf32
    sw.WriteLine $"U+{utf32:X6} UTF-32 = {surrogate} ({showCodePoints surrogate}) UTF-16"
    sw.Close()
    
    // The example produces the following output:
    //       U+01D160 UTF-32 = ð (U+D834 U+DD60) UTF-16
    
    Imports System.IO
    
    Module Example
       Public Sub Main()
          Dim sw As New StreamWriter(".\chars2.txt")
          Dim utf32 As Integer = &h1D160
          Dim surrogate As String = Char.ConvertFromUtf32(utf32)
          sw.WriteLine("U+{0:X6} UTF-32 = {1} ({2}) UTF-16", 
                       utf32, surrogate, ShowCodePoints(surrogate))
          sw.Close()                    
       End Sub
    
       Private Function ShowCodePoints(value As String) As String
          Dim retval As String = Nothing
          For Each ch In value
             retval += String.Format("U+{0:X4} ", Convert.ToUInt16(ch))
          Next
          Return retval.Trim()
       End Function
    End Module
    ' The example produces the following output:
    '       U+01D160 UTF-32 = ð (U+D834 U+DD60) UTF-16
    

문자 및 문자 범주

각 유니코드 문자 또는 유효한 서로게이트 쌍은 유니코드 범주에 속합니다. .NET에서 유니코드 범주는 열거형의 UnicodeCategory 멤버로 표시되며, 예를 들어 , UnicodeCategory.LowercaseLetterUnicodeCategory.SpaceSeparator등의 UnicodeCategory.CurrencySymbol값을 포함합니다.

문자의 유니코드 범주를 확인하려면 메서드를 호출합니다 GetUnicodeCategory . 예를 들어 다음 예제에서는 문자열에서 GetUnicodeCategory 각 문자의 유니코드 범주를 표시하기 위해 호출합니다. 이 예제는 인스턴스에 String 서로게이트 쌍이 없는 경우에만 올바르게 작동합니다.

using System;
using System.Globalization;

class Example
{
   public static void Main()
   {
      // Define a string with a variety of character categories.
      String s = "The red car drove down the long, narrow, secluded road.";
      // Determine the category of each character.
      foreach (var ch in s)
         Console.WriteLine("'{0}': {1}", ch, Char.GetUnicodeCategory(ch));
   }
}
// The example displays the following output:
//      'T': UppercaseLetter
//      'h': LowercaseLetter
//      'e': LowercaseLetter
//      ' ': SpaceSeparator
//      'r': LowercaseLetter
//      'e': LowercaseLetter
//      'd': LowercaseLetter
//      ' ': SpaceSeparator
//      'c': LowercaseLetter
//      'a': LowercaseLetter
//      'r': LowercaseLetter
//      ' ': SpaceSeparator
//      'd': LowercaseLetter
//      'r': LowercaseLetter
//      'o': LowercaseLetter
//      'v': LowercaseLetter
//      'e': LowercaseLetter
//      ' ': SpaceSeparator
//      'd': LowercaseLetter
//      'o': LowercaseLetter
//      'w': LowercaseLetter
//      'n': LowercaseLetter
//      ' ': SpaceSeparator
//      't': LowercaseLetter
//      'h': LowercaseLetter
//      'e': LowercaseLetter
//      ' ': SpaceSeparator
//      'l': LowercaseLetter
//      'o': LowercaseLetter
//      'n': LowercaseLetter
//      'g': LowercaseLetter
//      ',': OtherPunctuation
//      ' ': SpaceSeparator
//      'n': LowercaseLetter
//      'a': LowercaseLetter
//      'r': LowercaseLetter
//      'r': LowercaseLetter
//      'o': LowercaseLetter
//      'w': LowercaseLetter
//      ',': OtherPunctuation
//      ' ': SpaceSeparator
//      's': LowercaseLetter
//      'e': LowercaseLetter
//      'c': LowercaseLetter
//      'l': LowercaseLetter
//      'u': LowercaseLetter
//      'd': LowercaseLetter
//      'e': LowercaseLetter
//      'd': LowercaseLetter
//      ' ': SpaceSeparator
//      'r': LowercaseLetter
//      'o': LowercaseLetter
//      'a': LowercaseLetter
//      'd': LowercaseLetter
//      '.': OtherPunctuation
open System

// Define a string with a variety of character categories.
let s = "The red car drove down the long, narrow, secluded road."
// Determine the category of each character.
for ch in s do
    printfn $"'{ch}': {Char.GetUnicodeCategory ch}"

// The example displays the following output:
//      'T': UppercaseLetter
//      'h': LowercaseLetter
//      'e': LowercaseLetter
//      ' ': SpaceSeparator
//      'r': LowercaseLetter
//      'e': LowercaseLetter
//      'd': LowercaseLetter
//      ' ': SpaceSeparator
//      'c': LowercaseLetter
//      'a': LowercaseLetter
//      'r': LowercaseLetter
//      ' ': SpaceSeparator
//      'd': LowercaseLetter
//      'r': LowercaseLetter
//      'o': LowercaseLetter
//      'v': LowercaseLetter
//      'e': LowercaseLetter
//      ' ': SpaceSeparator
//      'd': LowercaseLetter
//      'o': LowercaseLetter
//      'w': LowercaseLetter
//      'n': LowercaseLetter
//      ' ': SpaceSeparator
//      't': LowercaseLetter
//      'h': LowercaseLetter
//      'e': LowercaseLetter
//      ' ': SpaceSeparator
//      'l': LowercaseLetter
//      'o': LowercaseLetter
//      'n': LowercaseLetter
//      'g': LowercaseLetter
//      ',': OtherPunctuation
//      ' ': SpaceSeparator
//      'n': LowercaseLetter
//      'a': LowercaseLetter
//      'r': LowercaseLetter
//      'r': LowercaseLetter
//      'o': LowercaseLetter
//      'w': LowercaseLetter
//      ',': OtherPunctuation
//      ' ': SpaceSeparator
//      's': LowercaseLetter
//      'e': LowercaseLetter
//      'c': LowercaseLetter
//      'l': LowercaseLetter
//      'u': LowercaseLetter
//      'd': LowercaseLetter
//      'e': LowercaseLetter
//      'd': LowercaseLetter
//      ' ': SpaceSeparator
//      'r': LowercaseLetter
//      'o': LowercaseLetter
//      'a': LowercaseLetter
//      'd': LowercaseLetter
//      '.': OtherPunctuation
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define a string with a variety of character categories.
      Dim s As String = "The car drove down the narrow, secluded road."
      ' Determine the category of each character.
      For Each ch In s
         Console.WriteLine("'{0}': {1}", ch, Char.GetUnicodeCategory(ch)) 
      Next
   End Sub
End Module
' The example displays the following output:
'       'T': UppercaseLetter
'       'h': LowercaseLetter
'       'e': LowercaseLetter
'       ' ': SpaceSeparator
'       'r': LowercaseLetter
'       'e': LowercaseLetter
'       'd': LowercaseLetter
'       ' ': SpaceSeparator
'       'c': LowercaseLetter
'       'a': LowercaseLetter
'       'r': LowercaseLetter
'       ' ': SpaceSeparator
'       'd': LowercaseLetter
'       'r': LowercaseLetter
'       'o': LowercaseLetter
'       'v': LowercaseLetter
'       'e': LowercaseLetter
'       ' ': SpaceSeparator
'       'd': LowercaseLetter
'       'o': LowercaseLetter
'       'w': LowercaseLetter
'       'n': LowercaseLetter
'       ' ': SpaceSeparator
'       't': LowercaseLetter
'       'h': LowercaseLetter
'       'e': LowercaseLetter
'       ' ': SpaceSeparator
'       'l': LowercaseLetter
'       'o': LowercaseLetter
'       'n': LowercaseLetter
'       'g': LowercaseLetter
'       ',': OtherPunctuation
'       ' ': SpaceSeparator
'       'n': LowercaseLetter
'       'a': LowercaseLetter
'       'r': LowercaseLetter
'       'r': LowercaseLetter
'       'o': LowercaseLetter
'       'w': LowercaseLetter
'       ',': OtherPunctuation
'       ' ': SpaceSeparator
'       's': LowercaseLetter
'       'e': LowercaseLetter
'       'c': LowercaseLetter
'       'l': LowercaseLetter
'       'u': LowercaseLetter
'       'd': LowercaseLetter
'       'e': LowercaseLetter
'       'd': LowercaseLetter
'       ' ': SpaceSeparator
'       'r': LowercaseLetter
'       'o': LowercaseLetter
'       'a': LowercaseLetter
'       'd': LowercaseLetter
'       '.': OtherPunctuation

내부적으로 ASCII 범위(U+0000~ U+00FF)를 벗어난 문자의 GetUnicodeCategory 경우 메서드는 클래스에서 보고한 CharUnicodeInfo 유니코드 범주에 따라 달라집니다. .NET Framework 4.6.2부터 유니코드 문자는 유니코드 표준 버전 8.0.0을 기반으로 분류됩니다. .NET Framework 4에서 .NET Framework 4.6.1까지의 .NET Framework 버전에서는 유니코드 표준 버전 6.3.0을 기반으로 분류됩니다.

문자 및 텍스트 요소

단일 문자는 여러 Char 개체로 나타낼 수 있으므로 개별 Char 개체로 작업하는 것이 항상 의미가 있는 것은 아닙니다. 예를 들어 다음 예제에서는 0부터 9까지의 에게 해를 나타내는 유니코드 코드 요소를 UTF-16 인코딩된 코드 단위로 변환합니다. 개체를 문자와 잘못 동일시 Char 하므로 결과 문자열에 20자가 있다고 부정확하게 보고합니다.

using System;

public class Example
{
   public static void Main()
   {
      string result = String.Empty;
      for (int ctr = 0x10107; ctr <= 0x10110; ctr++)  // Range of Aegean numbers.
         result += Char.ConvertFromUtf32(ctr);

      Console.WriteLine("The string contains {0} characters.", result.Length);
   }
}
// The example displays the following output:
//     The string contains 20 characters.
open System

let result =
    [ for i in 0x10107..0x10110 do  // Range of Aegean numbers.
        Char.ConvertFromUtf32 i ]
    |> String.concat ""

printfn $"The string contains {result.Length} characters."


// The example displays the following output:
//     The string contains 20 characters.
Module Example
   Public Sub Main()
      Dim result As String = String.Empty
      For ctr As Integer = &h10107 To &h10110     ' Range of Aegean numbers.
         result += Char.ConvertFromUtf32(ctr)
      Next         
      Console.WriteLine("The string contains {0} characters.", result.Length) 
   End Sub
End Module
' The example displays the following output:
'     The string contains 20 characters.

개체가 단일 문자를 나타낸다는 Char 가정을 방지하려면 다음을 수행할 수 있습니다.

  • 언어 콘텐츠를 나타내고 분석하기 위해 개별 문자로 작업하는 대신 개체 전체를 사용할 String 수 있습니다.

  • 다음 예제와 같이 사용할 String.EnumerateRunes 수 있습니다.

    int CountLetters(string s)
    {
        int letterCount = 0;
    
        foreach (Rune rune in s.EnumerateRunes())
        {
            if (Rune.IsLetter(rune))
            { letterCount++; }
        }
    
        return letterCount;
    }
    
    let countLetters (s: string) =
        let mutable letterCount = 0
    
        for rune in s.EnumerateRunes() do
            if Rune.IsLetter rune then
                letterCount <- letterCount + 1
    
        letterCount
    
  • 클래스를 StringInfo 사용하여 개별 Char 개체 대신 텍스트 요소를 사용할 수 있습니다. 다음 예제에서는 개체를 StringInfo 사용하여 에게 해 숫자 0에서 9로 구성된 문자열의 텍스트 요소 수를 계산합니다. 서로게이트 쌍을 단일 문자로 간주하므로 문자열에 10자가 포함되어 있음을 올바르게 보고합니다.

    using System;
    using System.Globalization;
    
    public class Example
    {
       public static void Main()
       {
          string result = String.Empty;
          for (int ctr = 0x10107; ctr <= 0x10110; ctr++)  // Range of Aegean numbers.
             result += Char.ConvertFromUtf32(ctr);
    
          StringInfo si = new StringInfo(result);
          Console.WriteLine("The string contains {0} characters.",
                            si.LengthInTextElements);
       }
    }
    // The example displays the following output:
    //       The string contains 10 characters.
    
    open System
    open System.Globalization
    
    let result =
        [ for i in 0x10107..0x10110 do  // Range of Aegean numbers.
            Char.ConvertFromUtf32 i ]
        |> String.concat ""
    
    
    let si = StringInfo result
    printfn $"The string contains {si.LengthInTextElements} characters."
    
    // The example displays the following output:
    //       The string contains 10 characters.
    
    Imports System.Globalization
    
    Module Example
       Public Sub Main()
          Dim result As String = String.Empty
          For ctr As Integer = &h10107 To &h10110     ' Range of Aegean numbers.
             result += Char.ConvertFromUtf32(ctr)
          Next         
          Dim si As New StringInfo(result)
          Console.WriteLine("The string contains {0} characters.", si.LengthInTextElements) 
       End Sub
    End Module
    ' The example displays the following output:
    '       The string contains 10 characters.
    
  • 문자열에 하나 이상의 결합 문자가 있는 기본 문자가 포함된 경우 메서드를 호출 String.Normalize 하여 부분 문자열을 단일 UTF-16 인코딩된 코드 단위로 변환할 수 있습니다. 다음 예제에서는 메서드를 호출 String.Normalize 하여 기본 문자 U+0061(LATIN SMALL LETTER A)을 변환하고 U+0308(DIAERESIS 결합)을 U+00E4(LATIN SMALL LETTER A WITH DIAERESIS)로 결합합니다.

    using System;
    
    public class Example
    {
       public static void Main()
       {
          string combining = "\u0061\u0308";
          ShowString(combining);
    
          string normalized = combining.Normalize();
          ShowString(normalized);
       }
    
       private static void ShowString(string s)
       {
          Console.Write("Length of string: {0} (", s.Length);
          for (int ctr = 0; ctr < s.Length; ctr++) {
             Console.Write("U+{0:X4}", Convert.ToUInt16(s[ctr]));
             if (ctr != s.Length - 1) Console.Write(" ");
          }
          Console.WriteLine(")\n");
       }
    }
    // The example displays the following output:
    //       Length of string: 2 (U+0061 U+0308)
    //
    //       Length of string: 1 (U+00E4)
    
    open System
    
    let showString (s: string) =
        printf $"Length of string: {s.Length} ("
        for i = 0 to s.Length - 1 do
            printf $"U+{Convert.ToUInt16 s[i]:X4}"
            if i <> s.Length - 1 then printf " "
        printfn ")\n"
    
    let combining = "\u0061\u0308"
    showString combining
    
    let normalized = combining.Normalize()
    showString normalized
    
    // The example displays the following output:
    //       Length of string: 2 (U+0061 U+0308)
    //
    //       Length of string: 1 (U+00E4)
    
    Module Example
       Public Sub Main()
          Dim combining As String = ChrW(&h0061) + ChrW(&h0308)
          ShowString(combining)
          
          Dim normalized As String = combining.Normalize()
          ShowString(normalized)
       End Sub
       
       Private Sub ShowString(s As String)
          Console.Write("Length of string: {0} (", s.Length)
          For ctr As Integer = 0 To s.Length - 1
             Console.Write("U+{0:X4}", Convert.ToUInt16(s(ctr)))
             If ctr <> s.Length - 1 Then Console.Write(" ")
          Next 
          Console.WriteLine(")")
          Console.WriteLine()
       End Sub
    End Module
    ' The example displays the following output:
    '       Length of string: 2 (U+0061 U+0308)
    '       
    '       Length of string: 1 (U+00E4)
    

일반 작업

구조체는 Char 개체를 비교 Char 하고, 현재 Char 개체의 값을 다른 형식의 개체로 변환하고, 개체의 유니코드 범주를 결정하는 메서드를 Char 제공합니다.

원하는 작업 이러한 System.Char 메서드 사용
개체 비교 Char CompareToEquals
코드 포인트를 문자열로 변환 ConvertFromUtf32

형식도 참조하세요 Rune .
Char 개체 또는 서로게이트 개체 쌍 Char 을 코드 포인트로 변환 단일 문자의 경우: Convert.ToInt32(Char)

서로게이트 쌍 또는 문자열의 문자: Char.ConvertToUtf32

형식도 참조하세요 Rune .
문자의 유니코드 범주 가져오기 GetUnicodeCategory

Rune.GetUnicodeCategory을 참조하세요.
문자가 숫자, 문자, 문장 부호, 컨트롤 문자 등과 같은 특정 유니코드 범주에 있는지 확인 IsControl, IsDigit, IsHighSurrogate, IsLetter, IsLetterOrDigit, , IsLower, IsNumberIsLowSurrogate, IsPunctuation, IsSeparator, IsSurrogate, IsSurrogatePairIsSymbol, IsUpperIsWhiteSpace

형식에 대한 Rune 해당 메서드도 참조하세요.
Char 숫자를 나타내는 개체를 숫자 값 형식으로 변환 GetNumericValue

Rune.GetNumericValue을 참조하세요.
문자열의 문자를 개체로 Char 변환 ParseTryParse
개체를 Char 개체로 String 변환 ToString
개체의 대/소문자 Char 변경 ToLower, ToLowerInvariant, ToUpperToUpperInvariant

형식에 대한 Rune 해당 메서드도 참조하세요.

Char 값 및 interop

유니코드 UTF-16으로 인코딩된 코드 단위로 표현되는 관리 Char 되는 형식이 관리되지 않는 코드에 전달되면 interop 마샬러는 기본적으로 문자 집합을 ANSI로 변환합니다. 플랫폼 호출 선언에 특성을 적용하고 COM interop 선언에 StructLayoutAttribute 특성을 적용 DllImportAttribute 하여 마샬링된 Char 형식이 사용하는 문자 집합을 제어할 수 있습니다.

필드

MaxValue

Char의 가능한 최대값을 나타냅니다. 이 필드는 상수입니다.

MinValue

Char의 최소값을 나타냅니다. 이 필드는 상수입니다.

메서드

CompareTo(Char)

이 인스턴스를 지정된 Char 개체와 비교하고 정렬 순서에서 이 인스턴스의 위치가 지정된 Char 개체보다 앞인지, 뒤인지 또는 동일한지를 나타냅니다.

CompareTo(Object)

이 인스턴스를 지정된 개체와 비교하고 정렬 순서에서 이 인스턴스의 위치가 지정된 Object 개체보다 앞인지, 뒤인지 또는 동일한지를 나타냅니다.

ConvertFromUtf32(Int32)

지정된 유니코드 코드 포인트를 UTF-16으로 인코딩된 문자열로 변환합니다.

ConvertToUtf32(Char, Char)

UTF-16으로 인코딩된 서로게이트 쌍의 값을 유니코드 코드 포인트로 변환합니다.

ConvertToUtf32(String, Int32)

문자열의 지정한 위치에 있는 UTF-16으로 인코딩된 문자 또는 서로게이트 쌍의 값을 유니코드 코드 포인트로 변환합니다.

Equals(Char)

이 인스턴스가 지정된 Char 개체와 같은지 여부를 나타내는 값을 반환합니다.

Equals(Object)

이 인스턴스가 지정된 개체와 같은지를 나타내는 값을 반환합니다.

GetHashCode()

이 인스턴스의 해시 코드를 반환합니다.

GetNumericValue(Char)

숫자 형식의 유니코드 문자를 배정밀도 부동 소수점 숫자로 변환합니다.

GetNumericValue(String, Int32)

지정된 문자열의 지정된 위치에 있는 숫자 형식의 유니코드 문자를 배정밀도 부동 소수점 숫자로 변환합니다.

GetTypeCode()

TypeCode 값 형식에 대한 Char를 반환합니다.

GetUnicodeCategory(Char)

지정한 유니코드 문자를 UnicodeCategory 값 중 하나로 식별되는 그룹으로 분류합니다.

GetUnicodeCategory(String, Int32)

지정된 문자열의 지정된 위치에 있는 문자를 UnicodeCategory 값 중 하나로 식별되는 그룹으로 분류합니다.

IsAscii(Char)

ASCII 문자([ U+0000..U+007F ])인 경우 c 를 반환 true 합니다.

IsControl(Char)

지정된 유니코드 문자가 제어 문자인지 여부를 나타냅니다.

IsControl(String, Int32)

지정된 문자열의 지정된 위치에 있는 문자가 제어 문자인지 여부를 나타냅니다.

IsDigit(Char)

유니코드 문자가 10진수인지 여부를 나타냅니다.

IsDigit(String, Int32)

지정된 문자열의 지정된 위치에 있는 문자가 10진수인지 여부를 나타냅니다.

IsHighSurrogate(Char)

지정한 Char 개체가 high surrogate인지 여부를 나타냅니다.

IsHighSurrogate(String, Int32)

문자열의 지정한 위치에 있는 Char 개체가 high surrogate인지 여부를 나타냅니다.

IsLetter(Char)

지정된 유니코드 문자가 유니코드 글자인지 여부를 나타냅니다.

IsLetter(String, Int32)

지정된 문자열의 지정된 위치에 있는 문자가 유니코드 글자인지 여부를 나타냅니다.

IsLetterOrDigit(Char)

지정된 유니코드 문자가 글자나 10진수인지 여부를 나타냅니다.

IsLetterOrDigit(String, Int32)

지정된 문자열의 지정된 위치에 있는 문자가 글자나 10진수인지 여부를 나타냅니다.

IsLower(Char)

유니코드 문자가 소문자 자모인지 여부를 나타냅니다.

IsLower(String, Int32)

지정된 문자열의 지정된 위치에 있는 자모가 소문자인지 여부를 나타냅니다.

IsLowSurrogate(Char)

지정한 Char 개체가 low surrogate인지 여부를 나타냅니다.

IsLowSurrogate(String, Int32)

문자열의 지정한 위치에 있는 Char 개체가 low surrogate인지 여부를 나타냅니다.

IsNumber(Char)

지정된 유니코드 문자가 숫자인지 여부를 나타냅니다.

IsNumber(String, Int32)

지정된 문자열의 지정된 위치에 있는 문자가 숫자인지 여부를 나타냅니다.

IsPunctuation(Char)

유니코드 문자가 문장 부호인지 여부를 나타냅니다.

IsPunctuation(String, Int32)

지정된 문자열의 지정된 위치에 있는 문자가 문장 부호인지 여부를 나타냅니다.

IsSeparator(Char)

유니코드 문자가 구분 문자인지 여부를 나타냅니다.

IsSeparator(String, Int32)

지정된 문자열의 지정된 위치에 있는 문자가 구분 문자인지 여부를 나타냅니다.

IsSurrogate(Char)

지정된 문자에 서로게이트 코드 단위가 있는지 여부를 나타냅니다.

IsSurrogate(String, Int32)

지정된 문자열의 지정된 위치에 있는 문자에 서로게이트 코드 단위가 있는지 여부를 나타냅니다.

IsSurrogatePair(Char, Char)

지정한 두 개의 Char 개체가 서로게이트 쌍을 형성하는지 여부를 나타냅니다.

IsSurrogatePair(String, Int32)

문자열의 지정한 위치에 있는 두 개의 인접한 Char 개체가 서로게이트 쌍을 형성하는지 여부를 나타냅니다.

IsSymbol(Char)

유니코드 문자가 기호 문자인지 여부를 나타냅니다.

IsSymbol(String, Int32)

지정된 문자열의 지정된 위치에 있는 문자가 기호 문자인지 여부를 나타냅니다.

IsUpper(Char)

유니코드 자모가 대문자인지 여부를 나타냅니다.

IsUpper(String, Int32)

지정된 문자열의 지정된 위치에 있는 문자가 대문자 자모인지 여부를 나타냅니다.

IsWhiteSpace(Char)

유니코드 문자가 공백인지 여부를 나타냅니다.

IsWhiteSpace(String, Int32)

지정된 문자열의 지정된 위치에 있는 문자가 공백인지 여부를 나타냅니다.

Parse(String)

지정된 문자열의 값을 해당하는 유니코드 문자로 변환합니다.

ToLower(Char)

유니코드 문자를 해당하는 소문자로 변환합니다.

ToLower(Char, CultureInfo)

문화권별 형식 지정 정보를 사용하여 지정된 유니코드 문자의 값을 해당하는 소문자로 변환합니다.

ToLowerInvariant(Char)

고정 문화권의 대/소문자 규칙을 사용하여 유니코드 문자의 값을 해당하는 소문자로 변환합니다.

ToString()

이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다.

ToString(Char)

지정된 유니코드 문자를 해당하는 문자열 표현으로 변환합니다.

ToString(IFormatProvider)

지정된 문화권별 형식 정보를 사용하여 이 인스턴스의 값을 해당 문자열 표현으로 변환합니다.

ToUpper(Char)

유니코드 문자를 해당하는 대문자로 변환합니다.

ToUpper(Char, CultureInfo)

문화권별 형식 지정 정보를 사용하여 지정된 유니코드 문자의 값을 해당하는 대문자로 변환합니다.

ToUpperInvariant(Char)

고정 문화권의 대/소문자 규칙을 사용하여 유니코드 문자의 값을 해당하는 대문자로 변환합니다.

TryParse(String, Char)

지정된 문자열의 값을 해당하는 유니코드 문자로 변환합니다. 반환 코드는 변환이 성공했는지 아니면 실패했는지를 나타냅니다.

명시적 인터페이스 구현

IComparable.CompareTo(Object)

현재 인스턴스와 동일한 형식의 다른 개체를 비교하고 정렬 순서에서 현재 인스턴스의 위치가 다른 개체보다 앞인지, 뒤인지 또는 동일한지를 나타내는 정수를 반환합니다.

IConvertible.GetTypeCode()

이 인스턴스에 대한 TypeCode를 반환합니다.

IConvertible.ToBoolean(IFormatProvider)

참고 이 변환은 지원되지 않습니다. 그렇게 하면 InvalidCastException이 throw됩니다.

IConvertible.ToByte(IFormatProvider)

이 멤버에 대한 설명은 ToByte(IFormatProvider)를 참조하세요.

IConvertible.ToChar(IFormatProvider)

이 멤버에 대한 설명은 ToChar(IFormatProvider)를 참조하세요.

IConvertible.ToDateTime(IFormatProvider)

참고 이 변환은 지원되지 않습니다. 그렇게 하면 InvalidCastException이 throw됩니다.

IConvertible.ToDecimal(IFormatProvider)

참고 이 변환은 지원되지 않습니다. 그렇게 하면 InvalidCastException이 throw됩니다.

IConvertible.ToDouble(IFormatProvider)

참고 이 변환은 지원되지 않습니다. 그렇게 하면 InvalidCastException이 throw됩니다.

IConvertible.ToInt16(IFormatProvider)

이 멤버에 대한 설명은 ToInt16(IFormatProvider)를 참조하세요.

IConvertible.ToInt32(IFormatProvider)

이 멤버에 대한 설명은 ToInt32(IFormatProvider)를 참조하세요.

IConvertible.ToInt64(IFormatProvider)

이 멤버에 대한 설명은 ToInt64(IFormatProvider)를 참조하세요.

IConvertible.ToSByte(IFormatProvider)

이 멤버에 대한 설명은 ToSByte(IFormatProvider)를 참조하세요.

IConvertible.ToSingle(IFormatProvider)

참고 이 변환은 지원되지 않습니다. 그렇게 하면 InvalidCastException이 throw됩니다.

IConvertible.ToString(IFormatProvider)

지정된 문화권별 형식 지정 정보를 사용하여 이 인스턴스의 값을 해당하는 문자열로 변환합니다.

IConvertible.ToType(Type, IFormatProvider)

이 멤버에 대한 설명은 ToType(Type, IFormatProvider)를 참조하세요.

IConvertible.ToUInt16(IFormatProvider)

이 멤버에 대한 설명은 ToUInt16(IFormatProvider)를 참조하세요.

IConvertible.ToUInt32(IFormatProvider)

이 멤버에 대한 설명은 ToUInt32(IFormatProvider)를 참조하세요.

IConvertible.ToUInt64(IFormatProvider)

이 멤버에 대한 설명은 ToUInt64(IFormatProvider)를 참조하세요.

IFormattable.ToString(String, IFormatProvider)

지정된 형식을 사용하여 현재 인스턴스 값의 형식을 지정합니다.

ISpanFormattable.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)

현재 인스턴스의 값을 제공된 문자 범위로 서식을 지정하려고 시도합니다.

적용 대상

스레드 보안

이 형식의 모든 멤버는 스레드로부터 안전합니다. 인스턴스 상태를 수정하는 것처럼 보이는 멤버는 실제로 새 값으로 초기화된 새 인스턴스를 반환합니다. 다른 형식과 마찬가지로 이 형식의 인스턴스를 포함하는 공유 변수에 대한 읽기 및 쓰기는 스레드 안전을 보장하기 위해 잠금으로 보호되어야 합니다.

추가 정보