Freigeben über

Char.IsSurrogate Methode

  • Referenz

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.dll

Gibt an, ob ein Zeichen über einen Ersatzzeichencodeeinheit verfügt.

Überlädt

IsSurrogate(Char)

Gibt an, ob das angegebene Zeichen über einen Ersatzzeichencodeeinheit verfügt.
IsSurrogate(String, Int32)

Gibt an, ob das Zeichen an der angegebenen Position in einer angegebenen Zeichenfolge über einen Ersatzzeichen-Codeeinheit verfügt.

Beispiele

Das folgende Beispiel veranschaulicht die IsSurrogate Methode.

using namespace System;
int main()
{
   
   // - escape params specifying Unicode not implemented in v7.0
   Console::WriteLine( Char::IsSurrogate( 'a' ) ); // Output: "False"
}

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)

Gibt an, ob das angegebene Zeichen über einen Ersatzzeichencodeeinheit 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 auszuwertende Unicode-Zeichen.

Gibt zurück

Boolean

true, wenn c entweder ein hohes Ersatzzeichen oder ein niedriges Ersatzzeichen ist, andernfalls false.

Hinweise

Ein Ersatzzeichen 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 Interpretation, hat aber nur dann eine Bedeutung, wenn sie als Teil eines Ersatzzeichenpaars verwendet wird. Weitere Informationen zu Ersatzzeichenpaaren finden Sie im Unicode-Standard auf der Unicode-Startseite.

Siehe auch

Gilt für

IsSurrogate(String, Int32)

Gibt an, ob das Zeichen an der angegebenen Position in einer angegebenen Zeichenfolge über einen Ersatzzeichen-Codeeinheit verfügt.

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 in s auszuwertenden Zeichens.

Gibt zurück

Boolean

true, wenn das Zeichen an Position index in s entweder ein hohes Ersatzzeichen oder ein niedriges Ersatzzeichen ist, andernfalls false.

Ausnahmen

ArgumentNullException

s ist null.

ArgumentOutOfRangeException

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

Hinweise

Zeichenpositionen in einer Zeichenfolge werden ab 0 (null) indiziert.

Ein Ersatzzeichen 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 Interpretation, hat aber nur dann eine Bedeutung, wenn sie als Teil eines Ersatzzeichenpaars verwendet wird. Weitere Informationen zu Ersatzzeichenpaaren finden Sie im Unicode-Standard auf der Unicode-Startseite.

Siehe auch

Gilt für