StringToCharArray

Посимвольно копирует преобразованную из unicode в ansi строку в указанное место массива типа uchar. Функция возвращает количество скопированных элементов.

int  StringToCharArray(
   string  text_string,         // строка-источник
   uchar&  array[],             // массив
   int     start=0,             // начальная позиция в массиве
   int     count=-1,            // количество символов
   uint    codepage=CP_ACP      // кодовая страница
   );

Параметры

text_string

[in] Строка для копирования.

array[]

[out] Массив типа uchar.

start=0

[in] Позиция, с которой начинается копирование. По умолчанию 0.

count=-1

[in] Количество элементов массива для копирования. Определяет длину результатной строки. По умолчанию -1, что означает копирование до конца массива, либо до встречи символа '\0', завершающего строку. Символ '\0' также будет скопирован в массив-приемник, при этом размер динамического массива может быть увеличен при необходимости под размер строки. Если размер динамического массива больше длины строки, то размер массива уменьшен не будет.

codepage=CP_ACP

[in] Значение кодовой страницы. Для наиболее употребимых кодовых страниц предусмотрены соответствующие константы.

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

Количество скопированных элементов.

Примечание

При копировании функция StringToCharArray() также копирует символ '\0', завершающий строку. Для его исключения нужно явно указывать длину строки:

//--- пример копирования строки str в массив array[]
StringToCharArray(str,array,0,StringLen(str));

Смотри также

Использование кодовой страницы

NormalizeDoubleStringToColor