Char.IsSurrogate Char.IsSurrogate Char.IsSurrogate Char.IsSurrogate Method

Définition

Indique si un caractère possède une unité de code de substitution.Indicates whether a character has a surrogate code unit.

Surcharges

IsSurrogate(Char) IsSurrogate(Char) IsSurrogate(Char) IsSurrogate(Char)

Indique si le caractère spécifié possède une unité de code de substitution.Indicates whether the specified character has a surrogate code unit.

IsSurrogate(String, Int32) IsSurrogate(String, Int32) IsSurrogate(String, Int32) 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.Indicates whether the character at the specified position in a specified string has a surrogate code unit.

IsSurrogate(Char) IsSurrogate(Char) IsSurrogate(Char) IsSurrogate(Char)

Indique si le caractère spécifié possède une unité de code de substitution.Indicates whether the specified character has a surrogate code unit.

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 Char Char Char

Caractère Unicode à évaluer.The Unicode character to evaluate.

Retours

true si c est un substitut étendu ou faible ; sinon, false.true if c is either a high surrogate or a low surrogate; otherwise, false.

Exemples

L’exemple suivant illustre la IsSurrogate méthode.The following example demonstrates the IsSurrogate method.

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"
    }
}
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

Remarques

Un substitut est un Char objet avec une unité de code UTF-16 dans la plage comprise entre u + D800 et u + DFFF.A surrogate is a Char object with a UTF-16 code unit in the range from U+D800 to U+DFFF. Chaque caractère avec une unité de code dans cette plage appartient à UnicodeCategory.Surrogate la catégorie.Each character with a code unit in this range belongs to the UnicodeCategory.Surrogate category. 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.The individual surrogate code unit has no interpretation of its own, but has meaning only when used as part of a surrogate pair. Pour plus d’informations sur les paires de substitution, consultez la norme Unicode sur la page d’hébergement Unicode.For more information about surrogate pairs, see the Unicode Standard at the Unicode home page.

Voir aussi

IsSurrogate(String, Int32) IsSurrogate(String, Int32) IsSurrogate(String, Int32) 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.Indicates whether the character at the specified position in a specified string has a surrogate code unit.

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 String String String

Chaîne.A string.

index
Int32 Int32 Int32 Int32

Position du caractère à évaluer dans s.The position of the character to evaluate in s.

Retours

true si le caractère à la position index dans s est un substitut étendu ou faible ; sinon, false.true if the character at position index in s is a either a high surrogate or a low surrogate; otherwise, false.

Exceptions

index est inférieur à zéro ou supérieur à la dernière position dans s.index is less than zero or greater than the last position in s.

Exemples

L’exemple de code suivant IsSurrogateillustre.The following code example demonstrates IsSurrogate.

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"
    }
}
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

Remarques

Les positions de caractère dans une chaîne sont indexées à partir de zéro.Character positions in a string are indexed starting from zero.

Un substitut est un Char objet avec une unité de code UTF-16 dans la plage comprise entre u + D800 et u + DFFF.A surrogate is a Char object with a UTF-16 code unit in the range from U+D800 to U+DFFF. Chaque caractère avec une unité de code dans cette plage appartient à UnicodeCategory.Surrogate la catégorie.Each character with a code unit in this range belongs to the UnicodeCategory.Surrogate category. 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.The individual surrogate code unit has no interpretation of its own, but has meaning only when used as part of a surrogate pair. Pour plus d’informations sur les paires de substitution, consultez la norme Unicode sur la page d’hébergement Unicode.For more information about surrogate pairs, see the Unicode Standard at the Unicode home page.

Voir aussi

S’applique à