Текущий раздел:

Описания RDS

Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.32. Вспомогательный объект для работы с форматом CSV

А.5.32.3. rdsCSVSetItem – установить элемент текста

# Приложения

## Приложение А. Функции, константы и структуры RDS

### А.5. Сервисные функции и макросы RDS

#### А.5.32. Вспомогательный объект для работы с форматом CSV

##### А.5.32.3. rdsCSVSetItem – установить элемент текста

Функция rdsCSVSetItem устанавливает элемент текста CSV с указанными номерами строки и столбца.

      void RDSCALL rdsCSVSetItemA(
        RDS_HOBJECT Csv, // Объект
        int Line,        // Номер строки
        int Col,         // Номер столбца
        RDSCSTR Value    // Значение элемента (UTF8)
      );
      void RDSCALL rdsCSVSetItemW(
        RDS_HOBJECT Csv, // Объект
        int Line,        // Номер строки
        int Col,         // Номер столбца
        RDSWCSTR Value   // Значение элемента (UTF16)
      );
      // Функция-псевдоним
      void RDSCALL rdsCSVSetItem(
        RDS_HOBJECT Csv, // Объект
        int Line,        // Номер строки
        int Col,         // Номер столбца
        RDSXCSTR Value   // Значение элемента (кодировка по умолчанию)
      );

Тип указателя на эту функцию

RDS_VHoIIS (для UTF8) или RDS_VHoIIWs (для UTF16)

Параметры

Csv(RDS_HOBJECT)
  Идентификатор вспомогательного объекта для работы с CSV, ранее созданного функцией rdsCSVCreate.
Line(int)
  Номер строки (строки нумеруются, начиная с нуля).
Col(int)
  Номер столбца (столбцы нумеруются, начиная с нуля).
Value(RDSCSTR,RDSWCSTR,RDSXCSTR)
  Указатель на строку, которую нужно поместить в позицию текста (Line,Col). Если в тексте недостаточно строк или в строке недостаточно значений, текст автоматически будет дополнен пустыми элементами перед позицией (Line,Col).

Примечания

Эта функция успешно выполнится независимо от того, сколько строк в данный момент находится в тексте внутри объекта и сколько элементов находится в каждой строке. Например, если для пустого, не содержащего ни одного элемента текста вызвать функцию rdsCSVSetItem(Csv,2,1,"ABCD"), в текст будет добавлено две пустые строки с индексами 0 и 1, и строка с индексом 2, содержащая пустой элемент в нулевой колонке и текст «ABCD» в первой:

| Столбец 0 | Столбец 1
--- | --- | ---
Строка 0 |  |
Строка 1 |  |
Строка 2 |  | ABCD

Если после этого вызвать функцию rdsCSVSetItem(Csv,1,0,"EFGH"), текст внутри объекта примет следующий вид:

| Столбец 0 | Столбец 1
--- | --- | ---
Строка 0 |  |
Строка 1 | EFGH |
Строка 2 |  | ABCD

См. также

rdsCSVCreate, rdsCSVGetItem, RDS_CSV_LINE, RDS_CSV_TEXT.