Char 構造体

リファレンス

定義

名前空間:: System

アセンブリ:: System.Runtime.dll

アセンブリ:: netstandard.dll

アセンブリ:: mscorlib.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

文字を 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 : IComparable, IConvertible

public value class char : IComparable, IComparable<char>, IEquatable<char>

public struct Char : IComparable, IComparable<char>, IConvertible, IEquatable<char>

public struct Char : IComparable, IComparable<char>, IConvertible, IEquatable<char>, ISpanFormattable

[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

[<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 IComparable, IConvertible

Public Structure Char
Implements IComparable, IComparable(Of Char), IEquatable(Of Char)

継承: Object

ValueType
Char

属性: SerializableAttribute ComVisibleAttribute

実装: IComparable IComparable<Char> IConvertible IEquatable<Char> IFormattable ISpanFormattable

例

次のコード例は、のメソッドの一部を示しています 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 エンコードを使用して Unicode コードポイントを表します。オブジェクトの値 Char は、16 ビットの数値 (序数) です。

Unicode、スカラー値、コードポイント、サロゲートペア、UTF-16、および型についてよく知らない場合は Rune 、「.NETでの文字エンコードの概要」を参照してください。

次のセクションでは、オブジェクトと文字の関係を調べ、インスタンスで実行される一般的な Char タスクについて Char 説明します。これらのタスクの一部を実行する代わりに Rune 、.NET Core 3.0 で導入された型を検討することをお Char 勧めします。

Char オブジェクト、Unicode 文字、および文字列
文字と文字のカテゴリ
文字とテキスト要素
一般的な操作
Char 値と相互運用

Char オブジェクト、Unicode 文字、および文字列

オブジェクト String は、テキストの文字列を Char 表す構造体のシーケンシャルコレクションです。ほとんどの Unicode 文字は 1 つのオブジェクトで表されますが、基本文字、サロゲートペア、または文字シーケンスの組み合わせとしてエンコードされた文字は、複数のオブジェクトで表されます Char Char 。このため、オブジェクト内 Char の構造体は、必ずしも 1 つの String Unicode 文字と等しいとは限りません。

次の場合は、1 つの Unicode 文字を表す複数の 16 ビットコード単位が使用されます。

グリフ。1 文字または基本文字の後に 1 つ以上の組み合わせ文字で構成される場合があります。たとえば、文字は、コード単位が U+0061 のオブジェクトの後に、コード単位が Char Char U+0308 のオブジェクトによって表されます。 (文字は、U+00E4 のコード単位を持つ 1 つのオブジェクト Char でも定義できます)。次の例は、 2 つのオブジェクトで構成される文字を示 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:
//       ä

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:
//       ä

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:
'       ä

Unicode Basic 多言語プレーン (BMP) の外部の文字。 Unicode では、プレーン 0 を表す BMP に加えて、16 個のプレーンがサポートされています。 Unicode コードポイントは、プレーンを含む 21 ビット値によって UTF-32 で表されます。たとえば、U+1D160 は、SYMBOL の 8 番目の NOTE 文字を表します。 UTF-16 エンコードは 16 ビットしか持たないので、BMP の外部の文字は UTF-16 のサロゲートペアによって表されます。次の例は、U+1D160 に相当する UTF-32 (SYMBOL の 8 番目の注文字) が 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

文字と文字のカテゴリ

各 Unicode 文字または有効なサロゲートペアは、Unicode カテゴリに属します。 .NET では、Unicode カテゴリは列挙体のメンバーによって表され、などの値 UnicodeCategory UnicodeCategory.CurrencySymbol UnicodeCategory.LowercaseLetter が UnicodeCategory.SpaceSeparator 含まれます。

文字の Unicode カテゴリを確認するには、メソッドを呼び出 GetUnicodeCategory します。たとえば、次の例では、を呼び GetUnicodeCategory 出して、文字列内の各文字の Unicode カテゴリを表示します。この例は、インスタンスにサロゲートペアがない場合にのみ正しく動作 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) 以外の文字の場合、メソッドはクラスによって報告される Unicode カテゴリ GetUnicodeCategory に依存 CharUnicodeInfo します。 4.6.2 .NET Framework、Unicode 文字は Unicode 標準バージョン8.0.0に基づいて分類されます。 .NET Framework .NET Framework 4 から .NET Framework 4.6.1 のバージョンでは、Unicode Standard バージョン6.3.0に基づいて分類されます。

文字とテキスト要素

1 つの文字を複数のオブジェクトで表す可能性があるから、個々のオブジェクトを操作する場合 Char は必ずしも意味 Char がありません。たとえば、次の例では、0 から 9 の文字の数字を表す Unicode コードポイントを UTF-16 でエンコードされたコード単位に変換します。オブジェクトと文字が誤って同一なので、結果の文字列に 20 文字が含まれています。 Char

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.

オブジェクトが 1 つの文字を表すという想定を回避するには、 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 できます。次の例では、オブジェクトを使用して、0 から 9 の大きな数値で構成される文字列内のテキスト要素 StringInfo の数をカウントします。サロゲートペアは 1 文字と見なされるので、文字列に 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.

文字列に 1 つ以上の結合文字を含む基本文字が含まれている場合は、メソッドを呼び出して、部分文字列を 1 つの UTF-16 でエンコードされたコード単位 String.Normalize に変換できます。次の例では、メソッドを呼び出して、基本文字 U+0061 (ラテン小文字 A) を変換し、文字 String.Normalize U+0308 (COMBINING 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)

一般的な操作

構造体は、オブジェクトを比較し、現在のオブジェクトの値を別の型のオブジェクトに変換し、オブジェクトの Unicode カテゴリを Char Char 決定する Char メソッドを提供 Char します。

目的	これらのメソッド `System.Char` を使用する
オブジェクトの Char 比較	CompareTo および Equals
コードポイントを文字列に変換する	ConvertFromUtf32 型も参照 Rune してください。
オブジェクトまたは Char オブジェクトのサロゲートペアを Char コードポイントに変換する	1 文字の場合: Convert.ToInt32(Char) サロゲートペアまたは文字列内の文字の場合: Char.ConvertToUtf32 型も参照 Rune してください。
文字の Unicode カテゴリを取得する	GetUnicodeCategory 参照 Rune.GetUnicodeCategory.
文字が特定の Unicode カテゴリ (数字、文字、句読点、制御文字など) に含されているかどうかを判断します	IsControl IsDigit IsHighSurrogate IsLetter IsLetterOrDigit 、、、、、、、、、、 IsLower IsLowSurrogate IsNumber IsPunctuation IsSeparator IsSurrogate IsSurrogatePair IsSymbol IsUpper IsWhiteSpace 型の対応するメソッドも参照 Rune してください。
数値を Char 表すオブジェクトを数値型に変換する	GetNumericValue 参照 Rune.GetNumericValue.
文字列内の文字をオブジェクトに変換 Char する	Parse および TryParse
オブジェクトを Char オブジェクトに変換 String する	ToString
オブジェクトの大文字と小文字を変更 Char する	ToLower、ToLowerInvariant、ToUpper、および ToUpperInvariant 型の対応するメソッドも参照 Rune してください。

Char 値と相互運用

Unicode UTF-16 でエンコードされたコード単位として表されるマネージド型がアンマネージコードに渡される場合、相互運用マーシャラーは既定で文字セットを ANSI に変換します。 Char 属性をプラットフォーム呼び出し宣言に適用し、属性を COM 相互運用宣言に適用して、マーシャリングされた型で使用する文字セット DllImportAttribute StructLayoutAttribute を Char 制御できます。

フィールド

MaxValue	Char の最大有効値を表します。このフィールドは定数です。
MinValue	Char の最小有効値を表します。このフィールドは定数です。

メソッド

CompareTo(Char)	このインスタンスと指定した Char オブジェクトとを比較し、並べ替え順序において、このインスタンスの位置が指定した Char オブジェクトの前、後ろ、または同じのいずれであるかを示します。
CompareTo(Object)	このインスタンスと指定したオブジェクトとを比較し、並べ替え順序において、このインスタンスの位置が指定した Object の前、後ろ、または同じのいずれであるかを示します。
ConvertFromUtf32(Int32)	指定された Unicode コードポイントを UTF-16 エンコードの文字列に変換します。
ConvertToUtf32(Char, Char)	UTF-16 でエンコードされたサロゲートペアの値を Unicode コードポイントに変換します。
ConvertToUtf32(String, Int32)	文字列中の指定位置にある UTF-16 エンコード文字またはサロゲートペアの値を、Unicode コードポイントに変換します。
Equals(Char)	対象のインスタンスが、指定した Char オブジェクトに等しいかどうかを示す値を返します。
Equals(Object)	このインスタンスが、指定されたオブジェクトと等価であるかどうかを示す値を返します。
GetHashCode()	このインスタンスのハッシュコードを返します。
GetNumericValue(Char)	指定された Unicode の数字を倍精度浮動小数点数に変換します。
GetNumericValue(String, Int32)	指定した文字列の指定位置にある Unicode の数字を倍精度浮動小数点数に変換します。
GetTypeCode()	Char 値型の TypeCode を返します。
GetUnicodeCategory(Char)	指定された Unicode 文字を UnicodeCategory 値のいずれかで識別されるグループに分類します。
GetUnicodeCategory(String, Int32)	指定した文字列の指定位置にある文字を UnicodeCategory 値のいずれかで識別されるグループに分類します。
IsAscii(Char)	`true` `c` が ASCII 文字 ([U + 0000.. U + 007f]) の場合はを返します。
IsControl(Char)	指定した Unicode 文字が、制御文字かどうかを示します。
IsControl(String, Int32)	指定した文字列の指定位置にある文字が制御文字かどうかを示します。
IsDigit(Char)	指定した Unicode 文字が、10 進数の数字かどうかを示します。
IsDigit(String, Int32)	指定した文字列の指定位置にある文字が 10 進数の数字かどうかを示します。
IsHighSurrogate(Char)	指定された Char オブジェクトが上位サロゲートであるかどうかを示します。
IsHighSurrogate(String, Int32)	文字列中の指定された位置にある Char オブジェクトが、上位サロゲートであるかどうかを示します。
IsLetter(Char)	指定した Unicode 文字が Unicode 文字かどうかを示します。
IsLetter(String, Int32)	指定した文字列の指定位置にある文字が、Unicode 文字かどうかを示します。
IsLetterOrDigit(Char)	指定した Unicode 文字が文字または 10 進数の数字なのかどうかを示します。
IsLetterOrDigit(String, Int32)	指定した文字列の指定位置にある文字が文字または 10 進数の数字かどうかを示します。
IsLower(Char)	指定した Unicode 文字が小文字かどうかを示します。
IsLower(String, Int32)	指定した文字列の指定位置にある文字が、小文字かどうかを示します。
IsLowSurrogate(Char)	指定された Char オブジェクトが下位サロゲートであるかどうかを示します。
IsLowSurrogate(String, Int32)	文字列のうち、指定された位置にある Char オブジェクトが、下位サロゲートであるかどうかを示します。
IsNumber(Char)	指定された Unicode 文字が数字かどうかを示します。
IsNumber(String, Int32)	指定した文字列の指定位置にある文字が数字かどうかを示します。
IsPunctuation(Char)	指定した Unicode 文字が区切り記号かどうかを示します。
IsPunctuation(String, Int32)	指定した文字列の指定位置にある文字が区切り記号かどうかを示します。
IsSeparator(Char)	指定した Unicode 文字が区切り文字かどうかを示します。
IsSeparator(String, Int32)	指定した文字列の指定位置にある文字が区切り文字かどうかを示します。
IsSurrogate(Char)	指定した文字がサロゲートコード単位を持つかどうかを示します。
IsSurrogate(String, Int32)	指定した文字列の指定位置にある文字がサロゲートコード単位を持つかどうかを示します。
IsSurrogatePair(Char, Char)	指定された 2 つの Char オブジェクトがサロゲートペアを形成するかどうかを示します。
IsSurrogatePair(String, Int32)	文字列中の指定された位置で互いに隣接する 2 つの Char オブジェクトがサロゲートペアを形成するかどうかを示します。
IsSymbol(Char)	指定した Unicode 文字が記号かどうかを示します。
IsSymbol(String, Int32)	指定した文字列の指定位置にある文字が記号かどうかを示します。
IsUpper(Char)	指定した Unicode 文字が大文字かどうかを示します。
IsUpper(String, Int32)	指定した文字列の指定位置にある文字が大文字かどうかを示します。
IsWhiteSpace(Char)	指定した Unicode 文字が空白かどうかを示します。
IsWhiteSpace(String, Int32)	指定した文字列の指定位置にある文字が空白かどうかを示します。
Parse(String)	指定した文字列の値をそれと等価な Unicode 文字に変換します。
ToLower(Char)	Unicode 文字の値をそれと等価な小文字に変換します。
ToLower(Char, CultureInfo)	指定したカルチャ固有の書式情報を使用して、指定した Unicode 文字の値をそれと等価な小文字へ変換します。
ToLowerInvariant(Char)	インバリアントカルチャの大文字と小文字の規則を使用して、Unicode 文字の値を対応する小文字表現に変換します。
ToString()	このインスタンスの値を、それと等価の文字列形式に変換します。
ToString(Char)	指定した Unicode 文字をそれと等価な文字列形式に変換します。
ToString(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、このインスタンスの値をそれと等価な文字列形式に変換します。
ToUpper(Char)	Unicode 文字の値をそれと等価な大文字に変換します。
ToUpper(Char, CultureInfo)	指定したカルチャ固有の書式情報を使用して、指定した Unicode 文字の値をそれと等価な大文字へ変換します。
ToUpperInvariant(Char)	インバリアントカルチャの大文字と小文字の規則を使用して、Unicode 文字の値を対応する大文字表現に変換します。
TryParse(String, Char)	指定した文字列の値をそれと等価な Unicode 文字に変換します。リターンコードは、変換が成功したか失敗したかを示します。

明示的なインターフェイスの実装

IComparable.CompareTo(Object)	現在のインスタンスを同じ型の別のオブジェクトと比較し、現在のインスタンスの並べ替え順序での位置が、比較対象のオブジェクトと比べて前か、後か、または同じかを示す整数を返します。
IConvertible.GetTypeCode()	インスタンスの TypeCode を返します。
IConvertible.ToBoolean(IFormatProvider)	注: この変換はサポートされていません。変換を試みると、InvalidCastException がスローされます。
IConvertible.ToByte(IFormatProvider)	このメンバーの詳細については、「ToByte(IFormatProvider)」をご覧ください。
IConvertible.ToChar(IFormatProvider)	このメンバーの詳細については、「ToChar(IFormatProvider)」をご覧ください。
IConvertible.ToDateTime(IFormatProvider)	注: この変換はサポートされていません。変換を試みると、InvalidCastException がスローされます。
IConvertible.ToDecimal(IFormatProvider)	注: この変換はサポートされていません。変換を試みると、InvalidCastException がスローされます。
IConvertible.ToDouble(IFormatProvider)	注: この変換はサポートされていません。変換を試みると、InvalidCastException がスローされます。
IConvertible.ToInt16(IFormatProvider)	このメンバーの詳細については、「ToInt16(IFormatProvider)」をご覧ください。
IConvertible.ToInt32(IFormatProvider)	このメンバーの詳細については、「ToInt32(IFormatProvider)」をご覧ください。
IConvertible.ToInt64(IFormatProvider)	このメンバーの詳細については、「ToInt64(IFormatProvider)」をご覧ください。
IConvertible.ToSByte(IFormatProvider)	このメンバーの詳細については、「ToSByte(IFormatProvider)」をご覧ください。
IConvertible.ToSingle(IFormatProvider)	注: この変換はサポートされていません。変換を試みると、InvalidCastException がスローされます。
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)	現在のインスタンスの値を指定された文字スパンに書式設定します。

適用対象

スレッドセーフ

この型のすべてのメンバーはスレッドセーフです。インスタンスの状態を変更すると思えるメンバーは、実際には新しい値で初期化された新しいインスタンスを返します。他の型と同様に、この型のインスタンスを含む共有変数の読み取りおよび書き込みは、スレッドセーフを保証するためにロックによって保護する必要があります。

Char 構造体

定義

例

注釈

Char オブジェクト、Unicode 文字、および文字列

文字と文字のカテゴリ

文字とテキスト要素

一般的な操作

Char 値と相互運用

フィールド

メソッド

明示的なインターフェイスの実装

適用対象

スレッドセーフ

こちらもご覧ください

その他のリソース

Char 構造体

定義

例

注釈

Char オブジェクト、Unicode 文字、および文字列

文字と文字のカテゴリ

文字とテキスト要素

一般的な操作

Char 値と相互運用

フィールド

メソッド

明示的なインターフェイスの実装

適用対象

スレッド セーフ

こちらもご覧ください

その他のリソース

スレッドセーフ