此方法用于指示字符串指定位置的两个相邻Char对象是否形成代理对。
句法:
public static bool IsSurrogatePair (string s, int index);
参数:
s: It is a String.
index: It is the starting position of the pair of characters to evaluate within s.
返回值:如果s参数包括在位置索引和索引+ 1,和在位置索引范围中的字符的数字值从相邻的字符此方法返回true U+D800
通过U+DBFF
,和字符中的数值位置索引+1从U+DC00
到U+DFFF
否则返回false 。
例外情况:
- ArgumentNullException:如果s为null。
- ArgumentOutOfRangeException:如果索引不是s内的位置。
下面的程序说明了Char.IsSurrogatePair(String,Int32)方法的用法:
范例1:
// C# program to demonstrate the
// Char.IsSurrogatePair(String,
// Int32) Method
using System;
class GFG {
// Main Method
public static void Main()
{
try {
// calling check() Method
check("1234", 3);
check("Tsunami", 3);
check("psyc0lo", 4);
// declaring and initializing string s1
string s1 = new String(new char[] {'a',
'\uD800', '\uDC00', 'z' });
check(s1, 1);
}
catch (ArgumentNullException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
catch (ArgumentOutOfRangeException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
}
// Defining check() method
public static void check(string s, int i)
{
// checking condition
// using IsSurrogatePair() Method
bool val = Char.IsSurrogatePair(s, i);
// checking
if (val)
Console.WriteLine("String '{0}' contains "
+ "Surrogate pairs at s[{1}] and s[{2}]",
s, i, i + 1);
else
Console.WriteLine("String '{0}' does't contain any "
+ "Surrogate pairs at s[{1}] and s[{2}]",
s, i, i + 1);
}
}
输出:
String '1234' does't contain any Surrogate pairs at s[3] and s[4]
String 'Tsunami' does't contain any Surrogate pairs at s[3] and s[4]
String 'psyc0lo' does't contain any Surrogate pairs at s[4] and s[5]
String 'að??z' contains Surrogate pairs at s[1] and s[2]
示例2:对于ArgumentNullException
// C# program to demonstrate the
// Char.IsSurrogatePair(String,
// Int32) Method
using System;
class GFG {
// Main Method
public static void Main()
{
try {
// calling check() Method
check("1234", 3);
check("Tsunami", 3);
check("psyc0lo", 4);
// declaring and initializing string s1
string s1 = new String(new char[] {'a',
'\uD800', '\uDC00', 'z' });
check(s1, 1);
Console.WriteLine("");
Console.WriteLine("s is null");
check(null, 4);
}
catch (ArgumentNullException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
catch (ArgumentOutOfRangeException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
}
// Defining check() method
public static void check(string s, int i)
{
// checking condition
// using IsSurrogatePair() Method
bool val = Char.IsSurrogatePair(s, i);
// checking
if (val)
Console.WriteLine("String '{0}' contains "
+ "Surrogate pairs at s[{1}] and s[{2}]",
s, i, i + 1);
else
Console.WriteLine("String '{0}' does't contain any "
+ "Surrogate pairs at s[{1}] and s[{2}]",
s, i, i + 1);
}
}
输出:
String '1234' does't contain any Surrogate pairs at s[3] and s[4]
String 'Tsunami' does't contain any Surrogate pairs at s[3] and s[4]
String 'psyc0lo' does't contain any Surrogate pairs at s[4] and s[5]
String 'að??z' contains Surrogate pairs at s[1] and s[2]
s is null
Exception Thrown: System.ArgumentNullException
示例3:对于ArgumentOutOfRangeException
// C# program to demonstrate the
// Char.IsSurrogatePair(String,
// Int32) Method
using System;
class GFG {
// Main Method
public static void Main()
{
try {
// calling check() Method
check("1234", 3);
check("Tsunami", 3);
check("psyc0lo", 4);
// declaring and initializing string s1
string s1 = new String(new char[] {'a',
'\uD800', '\uDC00', 'z' });
check(s1, 1);
Console.WriteLine("");
Console.WriteLine("index is less than zero");
check("null", -4);
}
catch (ArgumentNullException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
catch (ArgumentOutOfRangeException e) {
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
}
// Defining check() method
public static void check(string s, int i)
{
// checking condition
// using IsSurrogatePair() Method
bool val = Char.IsSurrogatePair(s, i);
// checking
if (val)
Console.WriteLine("String '{0}' contains "
+ "Surrogate pairs at s[{1}] and s[{2}]",
s, i, i + 1);
else
Console.WriteLine("String '{0}' does not contain any "
+ "Surrogate pairs at s[{1}] and s[{2}]",
s, i, i + 1);
}
}
输出:
String '1234' does not contain any Surrogate pairs at s[3] and s[4]
String 'Tsunami' does not contain any Surrogate pairs at s[3] and s[4]
String 'psyc0lo' does not contain any Surrogate pairs at s[4] and s[5]
String 'að??z' contains Surrogate pairs at s[1] and s[2]
index is less than zero
Exception Thrown: System.ArgumentOutOfRangeException
参考:
- https://docs.microsoft.com/zh-cn/dotnet/api/system.char.issurrogatepair?view=netframework-4.7.2#System_Char_IsSurrogatePair_System_String_System_Int32_