Char.ConvertToUtf32 Methode

Definition

Konvertiert den Wert eines UTF-16-codierten Ersatzpaars in einen Unicode-Codepunkt.

Überlädt

Name Beschreibung
ConvertToUtf32(Char, Char)

Konvertiert den Wert eines UTF-16-codierten Ersatzpaars in einen Unicode-Codepunkt.

ConvertToUtf32(String, Int32)

Wandelt den Wert eines UTF-16-codierten Zeichen- oder Ersatzpaars an einer angegebenen Position in einer Zeichenfolge in einen Unicode-Codepunkt um.

Beispiele

Das folgende Codebeispiel veranschaulicht die ConvertToUtf32 Und ConvertFromUtf32 Methoden.

// This example demonstrates the Char.ConvertFromUtf32() method
//                           and Char.ConvertToUtf32() overloads.
using System;

class Sample
{
    public static void Main()
    {
    int letterA = 0x0041;  //U+00041 = LATIN CAPITAL LETTER A
    int music   = 0x1D161; //U+1D161 = MUSICAL SYMBOL SIXTEENTH NOTE
    string s1;
    string comment   = "Create a UTF-16 encoded string from a code point.";
    string comment1b = "Create a code point from a UTF-16 encoded string.";
    string comment2b = "Create a code point from a surrogate pair at a certain position in a string.";
    string comment2c = "Create a code point from a high surrogate and a low surrogate code point.";

//  Convert code point U+0041 to UTF-16. The UTF-16 equivalent of
//  U+0041 is a Char with hexadecimal value 0041.

    Console.WriteLine(comment);
    s1 = Char.ConvertFromUtf32(letterA);
    Console.Write("    1a) 0x{0:X} => ", letterA);
    Show(s1);
    Console.WriteLine();

//  Convert the lone UTF-16 character to a code point.

    Console.WriteLine(comment1b);
    letterA = Char.ConvertToUtf32(s1, 0);
    Console.Write("    1b) ");
    Show(s1);
    Console.WriteLine(" => 0x{0:X}", letterA);
    Console.WriteLine();

// -------------------------------------------------------------------

//  Convert the code point U+1D161 to UTF-16. The UTF-16 equivalent of
//  U+1D161 is a surrogate pair with hexadecimal values D834 and DD61.

    Console.WriteLine(comment);
    s1 = Char.ConvertFromUtf32(music);
    Console.Write("    2a) 0x{0:X} => ", music);
    Show(s1);
    Console.WriteLine();

//  Convert the surrogate pair in the string at index position
//  zero to a code point.

    Console.WriteLine(comment2b);
    music = Char.ConvertToUtf32(s1, 0);
    Console.Write("    2b) ");
    Show(s1);
    Console.WriteLine(" => 0x{0:X}", music);

//  Convert the high and low characters in the surrogate pair into a code point.

    Console.WriteLine(comment2c);
    music = Char.ConvertToUtf32(s1[0], s1[1]);
    Console.Write("    2c) ");
    Show(s1);
    Console.WriteLine(" => 0x{0:X}", music);
    }

    private static void Show(string s)
    {
    for (int x = 0; x < s.Length; x++)
        {
        Console.Write("0x{0:X}{1}",
                       (int)s[x],
                       ((x == s.Length-1)? String.Empty : ", "));
        }
    }
}
/*
This example produces the following results:

Create a UTF-16 encoded string from a code point.
    1a) 0x41 => 0x41
Create a code point from a UTF-16 encoded string.
    1b) 0x41 => 0x41

Create a UTF-16 encoded string from a code point.
    2a) 0x1D161 => 0xD834, 0xDD61
Create a code point from a surrogate pair at a certain position in a string.
    2b) 0xD834, 0xDD61 => 0x1D161
Create a code point from a high surrogate and a low surrogate code point.
    2c) 0xD834, 0xDD61 => 0x1D161

*/
open System

let show (s: string) =
    for x = 0 to s.Length - 1 do
        printf $"""0x{int s[x]:X}{if x = s.Length - 1 then String.Empty else ", "}"""                    

[<EntryPoint>]
let main _ =
    let letterA = 0x0041  //U+00041 = LATIN CAPITAL LETTER A
    let music   = 0x1D161 //U+1D161 = MUSICAL SYMBOL SIXTEENTH NOTE
    let comment   = "Create a UTF-16 encoded string from a code point."
    let comment1b = "Create a code point from a UTF-16 encoded string."
    let comment2b = "Create a code point from a surrogate pair at a certain position in a string."
    let comment2c = "Create a code point from a high surrogate and a low surrogate code point."

//  Convert code point U+0041 to UTF-16. The UTF-16 equivalent of
//  U+0041 is a Char with hexadecimal value 0041.

    printfn $"{comment}"
    let s1 = Char.ConvertFromUtf32 letterA
    printf $"    1a) 0x{letterA:X} => "
    show s1
    printfn ""

//  Convert the lone UTF-16 character to a code point.

    printfn $"{comment1b}"
    let letterA = Char.ConvertToUtf32(s1, 0)
    printf "    1b) "
    show s1
    printfn $" => 0x{letterA:X}"
    printfn ""

// -------------------------------------------------------------------

//  Convert the code point U+1D161 to UTF-16. The UTF-16 equivalent of
//  U+1D161 is a surrogate pair with hexadecimal values D834 and DD61.

    printfn $"{comment}"
    let s1 = Char.ConvertFromUtf32 music
    printf $"    2a) 0x{music:X} => "
    show s1
    printfn ""

//  Convert the surrogate pair in the string at index position
//  zero to a code point.

    printfn $"{comment2b}" 
    let music = Char.ConvertToUtf32(s1, 0)
    printf "    2b) "
    show s1
    printfn $" => 0x{music:X}"

//  Convert the high and low characters in the surrogate pair into a code point.

    printfn $"{comment2c}"
    let music = Char.ConvertToUtf32(s1[0], s1[1])
    printf "    2c) "
    show s1
    printfn $" => 0x{music:X}"

    0

// This example produces the following results:
//
// Create a UTF-16 encoded string from a code point.
//     1a) 0x41 => 0x41
// Create a code point from a UTF-16 encoded string.
//     1b) 0x41 => 0x41
//
// Create a UTF-16 encoded string from a code point.
//     2a) 0x1D161 => 0xD834, 0xDD61
// Create a code point from a surrogate pair at a certain position in a string.
//     2b) 0xD834, 0xDD61 => 0x1D161
// Create a code point from a high surrogate and a low surrogate code point.
//     2c) 0xD834, 0xDD61 => 0x1D161
Class Sample
   Public Shared Sub Main()
      Dim letterA As Integer = &H41    'U+00041 = LATIN CAPITAL LETTER A
      Dim music As Integer   = &H1D161 'U+1D161 = MUSICAL SYMBOL SIXTEENTH NOTE
      Dim s1 As String
      Dim comment   As String = "Create a UTF-16 encoded string from a code point."
      Dim comment1b As String = "Create a code point from a UTF-16 encoded string."
      Dim comment2b As String = "Create a code point from a surrogate pair at a certain position in a string."
      Dim comment2c As String = "Create a code point from a high surrogate and a low surrogate code point."
      
      '  Convert code point U+0041 to UTF-16. The UTF-16 equivalent of 
      '  U+0041 is a Char with hexadecimal value 0041.

      Console.WriteLine(comment)
      s1 = [Char].ConvertFromUtf32(letterA)
      Console.Write("    1a) 0x{0:X} => ", letterA)
      Show(s1)
      Console.WriteLine()
      
      '  Convert the lone UTF-16 character to a code point.

      Console.WriteLine(comment1b)
      letterA = [Char].ConvertToUtf32(s1, 0)
      Console.Write("    1b) ")
      Show(s1)
      Console.WriteLine(" => 0x{0:X}", letterA)
      Console.WriteLine()
      
      ' -------------------------------------------------------------------

      '  Convert the code point U+1D161 to UTF-16. The UTF-16 equivalent of 
      '  U+1D161 is a surrogate pair with hexadecimal values D834 and DD61.

      Console.WriteLine(comment)
      s1 = [Char].ConvertFromUtf32(music)
      Console.Write("    2a) 0x{0:X} => ", music)
      Show(s1)
      Console.WriteLine()
      
      '  Convert the surrogate pair in the string at index position 
      '  zero to a code point.

      Console.WriteLine(comment2b)
      music = [Char].ConvertToUtf32(s1, 0)
      Console.Write("    2b) ")
      Show(s1)
      Console.WriteLine(" => 0x{0:X}", music)
      
      '  Convert the high and low characters in the surrogate pair into a code point.

      Console.WriteLine(comment2c)
      music = [Char].ConvertToUtf32(s1.Chars(0), s1.Chars(1))
      Console.Write("    2c) ")
      Show(s1)
      Console.WriteLine(" => 0x{0:X}", music)
   End Sub
   
   Private Shared Sub Show(s As String)
      Dim x As Integer
      If s.Length = 0 Then Exit Sub
      For x = 0 To s.Length - 1
         Console.Write("0x{0:X}{1}", _
                        AscW(s.Chars(x)), _
                        IIf(x = s.Length - 1, [String].Empty, ", "))
      Next 
   End Sub 
End Class 
'
'This example produces the following results:
'
'Create a UTF-16 encoded string from a code point.
'    1a) 0x41 => 0x41
'Create a code point from a UTF-16 encoded string.
'    1b) 0x41 => 0x41
'
'Create a UTF-16 encoded string from a code point.
'    2a) 0x1D161 => 0xD834, 0xDD61
'Create a code point from a surrogate pair at a certain position in a string.
'    2b) 0xD834, 0xDD61 => 0x1D161
'Create a code point from a high surrogate and a low surrogate code point.
'    2c) 0xD834, 0xDD61 => 0x1D161
'

ConvertToUtf32(Char, Char)

Quelle:
Char.cs
Quelle:
Char.cs
Quelle:
Char.cs
Quelle:
Char.cs
Quelle:
Char.cs

Konvertiert den Wert eines UTF-16-codierten Ersatzpaars in einen Unicode-Codepunkt.

public:
 static int ConvertToUtf32(char highSurrogate, char lowSurrogate);
public static int ConvertToUtf32(char highSurrogate, char lowSurrogate);
static member ConvertToUtf32 : char * char -> int
Public Shared Function ConvertToUtf32 (highSurrogate As Char, lowSurrogate As Char) As Integer

Parameter

highSurrogate
Char

Eine hohe Ersatzcodeeinheit (d. r. eine Codeeinheit zwischen U+D800 und U+DBFF).

lowSurrogate
Char

Eine niedrige Ersatzcodeeinheit (d. r. eine Codeeinheit zwischen U+DC00 und U+DFFF).

Gibt zurück

Der 21-Bit-Unicode-Codepunkt, dargestellt durch die und highSurrogate die lowSurrogate Parameter.

Ausnahmen

highSurrogate befindet sich nicht im Bereich U+D800 bis U+DBFF oder lowSurrogate befindet sich nicht im Bereich U+DC00 bis U+DFFF.

Hinweise

Verwenden Sie diese Methode, um ein Ersatzpaar in einen 21-Bit-Unicode-Codepunkt zu konvertieren. Verwenden Sie die System.Text.UTF32Encoding Klasse, um UTF-16-Daten in UTF-32-Daten zu konvertieren.

Ordinarily, UTF-16 encoding represents a single Unicode character as a 16-bit code unit. Es unterstützt jedoch auch Ersatzpaare, mit denen ein einzelnes abstraktes Zeichen als zwei 16-Bit-Codeeinheiten dargestellt werden kann. Diese beiden Char Objekte müssen Codeeinheiten aufweisen, die zwischen U+D800 und U+DBFF für das erste (hohe) Surrogate und von U+DC00 bis U+DFFF für das zweite (niedrige) Surrogate reichen. Ersatzpaare werden nur durch UTF-16-Codierung unterstützt. Mit dieser Methode kann ein Zeichen, das durch ein UTF-16-Ersatzpaar dargestellt wird, mithilfe der UTF-32-Codierung in ein Zeichen konvertiert werden.

Weitere Informationen

Gilt für:

ConvertToUtf32(String, Int32)

Quelle:
Char.cs
Quelle:
Char.cs
Quelle:
Char.cs
Quelle:
Char.cs
Quelle:
Char.cs

Wandelt den Wert eines UTF-16-codierten Zeichen- oder Ersatzpaars an einer angegebenen Position in einer Zeichenfolge in einen Unicode-Codepunkt um.

public:
 static int ConvertToUtf32(System::String ^ s, int index);
public static int ConvertToUtf32(string s, int index);
static member ConvertToUtf32 : string * int -> int
Public Shared Function ConvertToUtf32 (s As String, index As Integer) As Integer

Parameter

s
String

Eine Zeichenfolge, die ein Zeichen- oder Ersatzpaar enthält.

index
Int32

Die Indexposition des Zeichen- oder Ersatzpaars in s.

Gibt zurück

Der 21-Bit-Unicode-Codepunkt, der durch das Zeichen- oder Ersatzpaar an der Position im s durch den index Parameter angegebenen Parameter dargestellt wird.

Ausnahmen

s ist null.

index ist keine Position innerhalb svon .

Die angegebene Indexposition enthält ein Ersatzpaar, und entweder das erste Zeichen im Paar ist kein gültiger hoher Ersatz oder das zweite Zeichen im Paar ist kein gültiger niedriger Ersatz.

Hinweise

Verwenden Sie diese Methode, um ein Zeichen- oder Ersatzpaar in einen 21-Bit-Unicode-Codepunkt zu konvertieren. Verwenden Sie die System.Text.UTF32Encoding Klasse, um UTF-16-Daten in UTF-32-Daten zu konvertieren.

Weitere Informationen

Gilt für: