Article
11/17/2011

Char.IsSurrogate Method (Char)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Indicates whether the specified character has a surrogate code point.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Function IsSurrogate ( _
    c As Char _
) As Boolean

public static bool IsSurrogate(
    char c
)

Parameters

c
Type: System.Char
A Unicode character.

Return Value

Type: System.Boolean
true if c is either a high surrogate or a low surrogate; otherwise, false.

Remarks

A surrogate is a Char object with a Unicode code point in the range from U+D800 to U+DFFF. Each character with a code point in this range belongs to the UnicodeCategory.Surrogate category. The individual surrogate code point has no interpretation of its own, but has meaning only when used as part of a surrogate pair. For more information about surrogate pairs, see the Unicode Standard at the Unicode home page.

Examples

The following example demonstrates IsSurrogate.


Module Example

   Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)

      ' 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. 

      outputBlock.Text &= Char.IsSurrogate("a"c) & vbCrLf       ' Output: "False"

   End Sub

End Module

using System;

public class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      string str = "\U00010F00"; // Unicode values between 0x10000 and 0x10FFF are represented by two 16-bit "surrogate" characters

      outputBlock.Text += Char.IsSurrogate('a') + "\n";     // Output: "False"
      outputBlock.Text += Char.IsSurrogate(str, 0) + "\n";  // Output: "True"
   }
}

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Partager via