Приложения

Приложение А. Функции, константы и структуры 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» в первой:

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

См. также

rdsCSVCreate, rdsCSVGetItem, RDS_CSV_LINE, RDS_CSV_TEXT.