Partage via

Char.IsSurrogate Méthode

  • Référence

Définition

Espace de noms:
System
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.dll

Indique si un caractère possède une unité de code de substitution.

Surcharges

IsSurrogate(Char)

Indique si le caractère spécifié possède une unité de code de substitution.
IsSurrogate(String, Int32)

Indique si le caractère figurant à la position spécifiée dans une chaîne spécifiée possède une unité de code de substitution.

Exemples

L’exemple suivant illustre la IsSurrogate méthode.

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)

Indique si le caractère spécifié possède une unité de code de substitution.

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

Paramètres

c
Char

Caractère Unicode à évaluer.

Retours

Boolean

true si c est un substitut étendu ou faible ; sinon, false.

Remarques

Un substitut est un Char objet avec une unité de code UTF-16 dans la plage comprise entre u + D800 et u + DFFF. Chaque caractère avec une unité de code dans cette plage appartient à la UnicodeCategory.Surrogate catégorie. L’unité de code de substitution individuelle n’a pas d’interprétation propre, mais n’a de sens que lorsqu’elle est utilisée dans le cadre d’une paire de substitution. Pour plus d’informations sur les paires de substitution, consultez la norme Unicode sur la page d’hébergement Unicode.

Voir aussi

S’applique à

IsSurrogate(String, Int32)

Indique si le caractère figurant à la position spécifiée dans une chaîne spécifiée possède une unité de code de substitution.

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

Paramètres

s
String

Chaîne.

index
Int32

Position du caractère à évaluer dans s.

Retours

Boolean

true si le caractère à la position index dans s est un substitut étendu ou faible ; sinon, false.

Exceptions

ArgumentNullException

s a la valeur null.

ArgumentOutOfRangeException

index est inférieur à zéro ou supérieur à la dernière position dans s.

Remarques

Les positions de caractère dans une chaîne sont indexées à partir de zéro.

Un substitut est un Char objet avec une unité de code UTF-16 dans la plage comprise entre u + D800 et u + DFFF. Chaque caractère avec une unité de code dans cette plage appartient à la UnicodeCategory.Surrogate catégorie. L’unité de code de substitution individuelle n’a pas d’interprétation propre, mais n’a de sens que lorsqu’elle est utilisée dans le cadre d’une paire de substitution. Pour plus d’informations sur les paires de substitution, consultez la norme Unicode sur la page d’hébergement Unicode.

Voir aussi

S’applique à