Char.IsSurrogate Método

Definição

Indica se um caractere tem uma unidade de código substituta.Indicates whether a character has a surrogate code unit.

Sobrecargas

IsSurrogate(Char)

Indica se o caractere especificado tem uma unidade de código substituta.Indicates whether the specified character has a surrogate code unit.

IsSurrogate(String, Int32)

Indica se o caractere na posição especificada em uma cadeia de caracteres especificada tem uma unidade de código de substituto.Indicates whether the character at the specified position in a specified string has a surrogate code unit.

IsSurrogate(Char)

Indica se o caractere especificado tem uma unidade de código substituta.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

Parâmetros

c
Char

O caractere Unicode a ser avaliado.The Unicode character to evaluate.

Retornos

true se c for um substituto alto ou um substituto baixo; caso contrário, false.true if c is either a high surrogate or a low surrogate; otherwise, false.

Exemplos

O exemplo a seguir demonstra o método IsSurrogate.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

Comentários

Um substituto é um objeto Char com uma unidade de código UTF-16 no intervalo de U + D800 para U + DFFF.A surrogate is a Char object with a UTF-16 code unit in the range from U+D800 to U+DFFF. Cada caractere com uma unidade de código neste intervalo pertence à categoria de UnicodeCategory.Surrogate.Each character with a code unit in this range belongs to the UnicodeCategory.Surrogate category. A unidade de código substituto individual não tem nenhuma interpretação própria, mas tem significado apenas quando usada como parte de um par substituto.The individual surrogate code unit has no interpretation of its own, but has meaning only when used as part of a surrogate pair. Para obter mais informações sobre pares substitutos, consulte o padrão Unicode na Home Page Unicode.For more information about surrogate pairs, see the Unicode Standard at the Unicode home page.

Veja também

IsSurrogate(String, Int32)

Indica se o caractere na posição especificada em uma cadeia de caracteres especificada tem uma unidade de código de substituto.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

Parâmetros

s
String

Uma cadeia de caracteres.A string.

index
Int32

A posição do caractere a ser avaliada em s.The position of the character to evaluate in s.

Retornos

true se o caractere na posição index em s é um substituto alto ou um substituto baixo; caso contrário, false.true if the character at position index in s is a either a high surrogate or a low surrogate; otherwise, false.

Exceções

s é null.s is null.

index é menor que zero ou maior que a última posição em s.index is less than zero or greater than the last position in s.

Exemplos

O exemplo de código a seguir demonstra IsSurrogate.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

Comentários

As posições de caractere em uma cadeia de caracteres são indexadas a partir de zero.Character positions in a string are indexed starting from zero.

Um substituto é um objeto Char com uma unidade de código UTF-16 no intervalo de U + D800 para U + DFFF.A surrogate is a Char object with a UTF-16 code unit in the range from U+D800 to U+DFFF. Cada caractere com uma unidade de código neste intervalo pertence à categoria de UnicodeCategory.Surrogate.Each character with a code unit in this range belongs to the UnicodeCategory.Surrogate category. A unidade de código substituto individual não tem nenhuma interpretação própria, mas tem significado apenas quando usada como parte de um par substituto.The individual surrogate code unit has no interpretation of its own, but has meaning only when used as part of a surrogate pair. Para obter mais informações sobre pares substitutos, consulte o padrão Unicode na Home Page Unicode.For more information about surrogate pairs, see the Unicode Standard at the Unicode home page.

Veja também

Aplica-se a