String.ToCharArray Метод

Ссылка

Определение

Пространство имен:: System

Сборки:: mscorlib.dll, System.Runtime.dll

Сборки:: netstandard.dll, System.Runtime.dll

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Копирует знаки данного экземпляра в массив знаков Юникода.

Перегрузки

ToCharArray(Int32, Int32)	Копирует знаки из указанной подстроки данного экземпляра в массив знаков Юникода.
ToCharArray()	Копирует знаки данного экземпляра в массив знаков Юникода.

ToCharArray(Int32, Int32)

Исходный код:: String.cs

Исходный код:: String.cs

Исходный код:: String.cs

Копирует знаки из указанной подстроки данного экземпляра в массив знаков Юникода.

public:
 cli::array <char> ^ ToCharArray(int startIndex, int length);

public char[] ToCharArray(int startIndex, int length);

member this.ToCharArray : int * int -> char[]

Public Function ToCharArray (startIndex As Integer, length As Integer) As Char()

Параметры

startIndex: Int32

Начальная позиция подстроки в данном экземпляре.

length: Int32

Длина подстроки в данном экземпляре.

Возвращаемое значение

Char[]

Массив знаков Юникода, элементами которого являются length знаков данного экземпляра начиная с позиции startIndex.

Исключения

ArgumentOutOfRangeException

Значение параметра startIndex или length меньше нуля.

-или-

startIndex + length больше длины этого экземпляра.

Примеры

В следующем примере подстрока в строке преобразуется в массив символов, а затем перечисляется и отображается элемент массива.

// Sample for String::ToCharArray(Int32, Int32)
using namespace System;
using namespace System::Collections;
int main()
{
   String^ str = "012wxyz789";
   array<Char>^arr;
   arr = str->ToCharArray( 3, 4 );
   Console::Write( "The letters in '{0}' are: '", str );
   Console::Write( arr );
   Console::WriteLine( "'" );
   Console::WriteLine( "Each letter in '{0}' is:", str );
   IEnumerator^ myEnum = arr->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Char c =  safe_cast<Char>(myEnum->Current);
      Console::WriteLine( c );
   }
}

/*
This example produces the following results:
The letters in '012wxyz789' are: 'wxyz'
Each letter in '012wxyz789' is:
w
x
y
z
*/

// Sample for String.ToCharArray(Int32, Int32)
using System;

class Sample {
    public static void Main() {
    string str = "012wxyz789";
    char[] arr;

    arr = str.ToCharArray(3, 4);
    Console.Write("The letters in '{0}' are: '", str);
    Console.Write(arr);
    Console.WriteLine("'");
    Console.WriteLine("Each letter in '{0}' is:", str);
    foreach (char c in arr)
        Console.WriteLine(c);
    }
}
/*
This example produces the following results:
The letters in '012wxyz789' are: 'wxyz'
Each letter in '012wxyz789' is:
w
x
y
z
*/

// Sample for String.ToCharArray(Int32, Int32)
let str = "012wxyz789"

let arr = str.ToCharArray(3, 4)
printf $"The letters in '{str}' are: '"
printf $"{arr}"
printfn "'"
printfn $"Each letter in '{str}' is:"
for c in arr do
    printfn $"{c}"
(*
This example produces the following results:
The letters in '012wxyz789' are: 'wxyz'
Each letter in '012wxyz789' is:
w
x
y
z
*)

' Sample for String.ToCharArray(Int32, Int32)
Class Sample
   
   Public Shared Sub Main()
      Dim str As String = "012wxyz789"
      Dim arr() As Char
      
      arr = str.ToCharArray(3, 4)
      Console.Write("The letters in '{0}' are: '", str)
      Console.Write(arr)
      Console.WriteLine("'")
      Console.WriteLine("Each letter in '{0}' is:", str)
      Dim c As Char
      For Each c In arr
         Console.WriteLine(c)
      Next c
   End Sub
End Class
'
'This example produces the following results:
'The letters in '012wxyz789' are: 'wxyz'
'Each letter in '012wxyz789' is:
'w
'x
'y
'z
'

Если length значение равно нулю, возвращаемый массив пуст и имеет нулевую длину. Если этот экземпляр имеет null значение или пустая строка (""), возвращаемый массив пуст и имеет нулевую длину.

Чтобы создать массив байтов, содержащий закодированные символы в части строки, создайте экземпляр соответствующего Encoding объекта и вызовите его GetBytes(String, Int32, Int32, Byte[], Int32) метод . Ниже перечислены некоторые стандартные кодировки, доступные в .NET.

Кодирование	Объект
ASCII	ASCIIEncoding
UTF-7	UTF7Encoding
UTF-8	UTF8Encoding
UTF-16	UnicodeEncoding
UTF-32	UTF32Encoding

Дополнительные сведения см. в разделе Кодировка символов в .NET.

См. также раздел

Применяется к

.NET 10 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

ToCharArray()

Исходный код:: String.cs

Исходный код:: String.cs

Исходный код:: String.cs

Копирует знаки данного экземпляра в массив знаков Юникода.

public:
 cli::array <char> ^ ToCharArray();

public char[] ToCharArray();

member this.ToCharArray : unit -> char[]

Public Function ToCharArray () As Char()

Возвращаемое значение

Char[]

Массив знаков Юникода, элементами которого являются отдельные знаки из данного экземпляра. Если этот экземпляр является пустой строкой, то возвращаемый массив пуст и его длина равна нулю.

Примеры

В следующем примере вызывается ToCharArray метод для извлечения символов в строке в массив символов. Затем отображается исходная строка и элементы в массиве.

using System;

public class Example
{
   public static void Main()
   {
      string s = "AaBbCcDd";
      char[] chars = s.ToCharArray();
      Console.WriteLine("Original string: {0}", s);
      Console.WriteLine("Character array:");
      for (int ctr = 0; ctr < chars.Length; ctr++)
      {
         Console.WriteLine("   {0}: {1}", ctr, chars[ctr]);
      }
   }
}

// The example displays the following output:
//     Original string: AaBbCcDd
//     Character array:
//        0: A
//        1: a
//        2: B
//        3: b
//        4: C
//        5: c
//        6: D
//        7: d

let s = "AaBbCcDd"
let chars = s.ToCharArray()
printfn $"Original string: {s}"
printfn "Character array:"
for i = 0 to chars.Length - 1 do
    printfn $"   {i}: {chars[i]}"

// The example displays the following output:
//     Original string: AaBbCcDd
//     Character array:
//        0: A
//        1: a
//        2: B
//        3: b
//        4: C
//        5: c
//        6: D
//        7: d

Module Example
   Public Sub Main()
      Dim s As String = "AaBbCcDd"
      Dim chars() = s.ToCharArray()
      Console.WriteLine("Original string: {0}", s)
      Console.WriteLine("Character array:")
      For ctr = 0 to chars.Length - 1
         Console.WriteLine("   {0}: {1}", ctr, chars(ctr))
      Next
   End Sub
End Module
' The example displays the following output:
'     Original string: AaBbCcDd
'     Character array:
'        0: A
'        1: a
'        2: B
'        3: b
'        4: C
'        5: c
'        6: D
'        7: d

Этот метод копирует каждый символ (т. е. каждый Char объект) в строке в массив символов. Первый скопированный символ равен нулю индекса возвращаемого массива символов; последний скопированный символ имеет индекс Array.Length - 1.

Чтобы создать строку из символов в массиве символов, вызовите String(Char[]) конструктор .

Чтобы создать массив байтов, содержащий закодированные символы в строке, создайте экземпляр соответствующего Encoding объекта и вызовите его Encoding.GetBytes(String) метод . Ниже перечислены некоторые стандартные кодировки, доступные в .NET.

Кодирование	Объект
ASCII	ASCIIEncoding
UTF-7	UTF7Encoding
UTF-8	UTF8Encoding
UTF-16	UnicodeEncoding
UTF-32	UTF32Encoding

Дополнительные сведения см. в разделе Кодировка символов в .NET.

См. также раздел

Char
Array

Применяется к

.NET 10 и другие версии

Продукт	Версии
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Фестиваль навыков ИИ

Поделиться через

String.ToCharArray Метод

Определение

Перегрузки

ToCharArray(Int32, Int32)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

ToCharArray()

Возвращаемое значение

Примеры

Комментарии

См. также раздел

Применяется к

Дополнительные ресурсы