Char.ConvertToUtf32 Methode

Definitie

Naamruimte:: System

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Converteert de waarde van een UTF-16 gecodeerd surrogaatpaar naar een Unicode-codepunt.

Overloads

Name	Description
ConvertToUtf32(Char, Char)	Converteert de waarde van een UTF-16 gecodeerd surrogaatpaar naar een Unicode-codepunt.
ConvertToUtf32(String, Int32)	Converteert de waarde van een UTF-16 gecodeerd teken of surrogaatpaar op een opgegeven positie in een tekenreeks naar een Unicode-codepunt.

Voorbeelden

In het volgende codevoorbeeld ziet u de ConvertToUtf32 en 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)

Converteert de waarde van een UTF-16 gecodeerd surrogaatpaar naar een Unicode-codepunt.

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

Parameters

highSurrogate: Char

Een hoge surrogaatcode-eenheid (een code-eenheid van U+D800 tot en met U+DBFF).

lowSurrogate: Char

Een lage surrogaatcode-eenheid (dat wil gezegd, een code-eenheid van U+DC00 tot en met U+DFFF).

Retouren

Int32

Het 21-bits Unicode-codepunt dat wordt vertegenwoordigd door de highSurrogate en lowSurrogate parameters.

Uitzonderingen

ArgumentOutOfRangeException

highSurrogate bevindt zich niet in het bereik U+D800 tot en met U+DBFF of lowSurrogate bevindt zich niet in het bereik U+DC00 tot en met U+DFFF.

Opmerkingen

Gebruik deze methode om een surrogaatpaar te converteren naar een 21-bits Unicode-codepunt. Als u UTF-16-gegevens wilt converteren naar UTF-32-gegevens, gebruikt u de System.Text.UTF32Encoding klasse.

Normaal gesproken vertegenwoordigt UTF-16-codering één Unicode-teken als een 16-bits code-eenheid. Het ondersteunt echter ook surrogaatparen, waardoor één abstract teken kan worden weergegeven als twee 16-bits code-eenheden. Deze twee Char objecten moeten code-eenheden hebben die variëren van U+D800 tot U+DBFF voor het eerste (hoge) surrogaat en van U+DC00 tot U+DFFF voor de tweede (lage) surrogaat. Surrogaatparen worden alleen ondersteund door UTF-16-codering. Met deze methode kan een teken dat wordt vertegenwoordigd door een UTF-16-surrogaatpaar worden geconverteerd naar een teken met behulp van UTF-32-codering.

Zie ook

Van toepassing op

ConvertToUtf32(String, Int32)

Converteert de waarde van een UTF-16 gecodeerd teken of surrogaatpaar op een opgegeven positie in een tekenreeks naar een Unicode-codepunt.

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

Parameters

s: String

Een tekenreeks die een teken of surrogaatpaar bevat.

index: Int32

De indexpositie van het teken of surrogaatpaar in s.

Retouren

Int32

Het 21-bits Unicode-codepunt dat wordt vertegenwoordigd door het teken of surrogaatpaar op de positie in de s parameter die is opgegeven door de index parameter.

Uitzonderingen

ArgumentNullException

s is null.

ArgumentOutOfRangeException

index is geen positie binnen s.

ArgumentException

De opgegeven indexpositie bevat een surrogaatpaar en het eerste teken in het paar is geen geldig hoog surrogaat of het tweede teken in het paar is geen geldig laag surrogaat.

Opmerkingen

Gebruik deze methode om een teken of surrogaatpaar te converteren naar een 21-bits Unicode-codepunt. Als u UTF-16-gegevens wilt converteren naar UTF-32-gegevens, gebruikt u de System.Text.UTF32Encoding klasse.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?