Char.IsSurrogate Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Gibt an, ob ein Zeichen über eine Ersatzcodeeinheit verfügt.

Überlädt

Name	Beschreibung
IsSurrogate(Char)	Gibt an, ob das angegebene Zeichen über eine Ersatzcodeeinheit verfügt.
IsSurrogate(String, Int32)	Gibt an, ob das Zeichen an der angegebenen Position in einer angegebenen Zeichenfolge eine Ersatzcodeeinheit aufweist.

Beispiele

Im folgenden Beispiel wird die IsSurrogate Methode veranschaulicht.

using System;

public class IsSurrogateSample {
    public static void Main() {
        string str = "\U00010F00"; // Unicode values between 0x10000 and 0x10FFF are represented by two 16-bit "surrogate" characters

        Console.WriteLine(Char.IsSurrogate('a'));		// Output: "False"
        Console.WriteLine(Char.IsSurrogate(str, 0));	// Output: "True"
    }
}

open System

let str = "\U00010F00" // Unicode values between 0x10000 and 0x10FFF are represented by two 16-bit "surrogate" characters

printfn $"{Char.IsSurrogate 'a'}"       // Output: "False"
printfn $"{Char.IsSurrogate(str, 0)}"   // Output: "True"

Module IsSurrogateSample

    Sub Main()

        ' NOTE: Visual Basic doesn't give us a way to create a 32-bit Unicode 
        ' character composed of two 16-bit surrogate values, so a case where 
        ' IsSurrogate returns True cannot be included in this sample. 

        Console.WriteLine(Char.IsSurrogate("a"c))       ' Output: "False"

    End Sub

End Module

IsSurrogate(Char)

Quelle:

Char.cs

Gibt an, ob das angegebene Zeichen über eine Ersatzcodeeinheit verfügt.

public:
 static bool IsSurrogate(char c);

public static bool IsSurrogate(char c);

static member IsSurrogate : char -> bool

Public Shared Function IsSurrogate (c As Char) As Boolean

Parameter

c

Char

Das unicode-Zeichen, das ausgewertet werden soll.

Gibt zurück

Boolean

true wenn c es sich um einen hohen Ersatz oder einen niedrigen Ersatz handelt; andernfalls false.

Hinweise

Ein Ersatz ist ein Char Objekt mit einer UTF-16-Codeeinheit im Bereich von U+D800 bis U+DFFF. Jedes Zeichen mit einer Codeeinheit in diesem Bereich gehört zur UnicodeCategory.Surrogate Kategorie. Die einzelne Ersatzcodeeinheit hat keine eigene Auslegung, hat aber nur bedeutungslos, wenn sie als Teil eines Ersatzpaars verwendet wird. Weitere Informationen zu Ersatzpaaren finden Sie im Unicode-Standard auf der Unicode-Startseite.

Weitere Informationen

• Rune
• IsHighSurrogate
• IsLowSurrogate
• IsSurrogatePair

IsSurrogate(String, Int32)

Quelle:

Char.cs

Gibt an, ob das Zeichen an der angegebenen Position in einer angegebenen Zeichenfolge eine Ersatzcodeeinheit aufweist.

public:
 static bool IsSurrogate(System::String ^ s, int index);

public static bool IsSurrogate(string s, int index);

static member IsSurrogate : string * int -> bool

Public Shared Function IsSurrogate (s As String, index As Integer) As Boolean

Parameter

s

String

Eine Zeichenfolge.

index

Int32

Die Position des Zeichens, in sdem ausgewertet werden soll.

Gibt zurück

Boolean

true wenn das Zeichen an der Position index ein s entweder ein hoher Ersatz oder ein niedriger Ersatz ist; andernfalls false.

Ausnahmen

ArgumentNullException

s ist null.

ArgumentOutOfRangeException

index ist kleiner als null oder größer als die letzte Position in s.

Hinweise

Zeichenpositionen in einer Zeichenfolge werden beginnend mit Null indiziert.

Ein Ersatz ist ein Char Objekt mit einer UTF-16-Codeeinheit im Bereich von U+D800 bis U+DFFF. Jedes Zeichen mit einer Codeeinheit in diesem Bereich gehört zur UnicodeCategory.Surrogate Kategorie. Die einzelne Ersatzcodeeinheit hat keine eigene Auslegung, hat aber nur bedeutungslos, wenn sie als Teil eines Ersatzpaars verwendet wird. Weitere Informationen zu Ersatzpaaren finden Sie im Unicode-Standard auf der Unicode-Startseite.

Weitere Informationen

• Rune
• IsHighSurrogate
• IsLowSurrogate
• IsSurrogatePair