Char.ConvertToUtf32 Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Konverterar värdet för ett UTF-16-kodat surrogatpar till en Unicode-kodpunkt.
Överlagringar
| Name | Description |
|---|---|
| ConvertToUtf32(Char, Char) |
Konverterar värdet för ett UTF-16-kodat surrogatpar till en Unicode-kodpunkt. |
| ConvertToUtf32(String, Int32) |
Konverterar värdet för ett UTF-16-kodat tecken eller surrogatpar vid en angiven position i en sträng till en Unicode-kodpunkt. |
Exempel
I följande kodexempel visas ConvertToUtf32 metoderna och ConvertFromUtf32 .
// 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)
- Källa:
- Char.cs
- Källa:
- Char.cs
- Källa:
- Char.cs
- Källa:
- Char.cs
- Källa:
- Char.cs
Konverterar värdet för ett UTF-16-kodat surrogatpar till en Unicode-kodpunkt.
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
Parametrar
- highSurrogate
- Char
En hög surrogatkodenhet (dvs. en kodenhet som sträcker sig från U+D800 till U+DBFF).
- lowSurrogate
- Char
En låg surrogatkodenhet (dvs. en kodenhet som sträcker sig från U+DC00 till U+DFFF).
Returer
21-bitars Unicode-kodpunkten som representeras av parametrarna highSurrogate och lowSurrogate .
Undantag
highSurrogate är inte inom intervallet U+D800 via U+DBFF eller lowSurrogate ligger inte i intervallet U+DC00 via U+DFFF.
Kommentarer
Använd den här metoden för att konvertera ett surrogatpar till en 21-bitars Unicode-kodpunkt. Om du vill konvertera UTF-16-data till UTF-32-data använder du System.Text.UTF32Encoding klassen .
Vanligtvis representerar UTF-16-kodning ett enda Unicode-tecken som en 16-bitars kodenhet. Den stöder dock även surrogatpar, vilket gör att ett enda abstrakt tecken kan representeras som två 16-bitars kodenheter. Dessa två Char objekt måste ha kodenheter som sträcker sig från U+D800 till U+DBFF för den första (höga) surrogaten och från U+DC00 till U+DFFF för den andra (låga) surrogaten. Surrogatpar stöds endast av UTF-16-kodning. Med den här metoden kan ett tecken som representeras av ett UTF-16 surrogatpar konverteras till ett tecken med UTF-32-kodning.
Se även
Gäller för
ConvertToUtf32(String, Int32)
- Källa:
- Char.cs
- Källa:
- Char.cs
- Källa:
- Char.cs
- Källa:
- Char.cs
- Källa:
- Char.cs
Konverterar värdet för ett UTF-16-kodat tecken eller surrogatpar vid en angiven position i en sträng till en Unicode-kodpunkt.
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
Parametrar
- s
- String
En sträng som innehåller ett tecken eller surrogatpar.
- index
- Int32
Indexpositionen för tecknet eller surrogatparet i s.
Returer
Den 21-bitars Unicode-kodpunkt som representeras av tecknet eller surrogatparet vid positionen i parametern s som anges av parametern index .
Undantag
s är null.
index är inte en position inom s.
Den angivna indexpositionen innehåller ett surrogatpar och antingen är det första tecknet i paret inte en giltig hög surrogat eller så är det andra tecknet i paret inte ett giltigt lågt surrogattecken.
Kommentarer
Använd den här metoden för att konvertera ett tecken- eller surrogatpar till en 21-bitars Unicode-kodpunkt. Om du vill konvertera UTF-16-data till UTF-32-data använder du System.Text.UTF32Encoding klassen .