Приложения

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

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

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

А.5.32.2. rdsCSVGetItem – получить элемент текста

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

  RDSSTR RDSCALL rdsCSVGetItemA( // UTF8
    RDS_HOBJECT Csv, // Объект
    int Line,        // Номер строки
    int Col          // Номер столбца
  );
  RDSWSTR RDSCALL rdsCSVGetItemW( // UTF16
    RDS_HOBJECT Csv, // Объект
    int Line,        // Номер строки
    int Col          // Номер столбца
  );
  // Функция-псевдоним
  RDSXSTR RDSCALL rdsCSVGetItem( // Кодировка по умолчанию
    RDS_HOBJECT Csv, // Объект
    int Line,        // Номер строки
    int Col          // Номер столбца
  );

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

RDS_SHoII (для UTF8) или RDS_WsHoII (для UTF16)

Параметры

Csv (RDS_HOBJECT)

Идентификатор вспомогательного объекта для работы с CSV, ранее созданного функцией rdsCSVCreate.

Line (int)

Номер строки (строки нумеруются, начиная с нуля).

Col (int)

Номер столбца (столбцы нумеруются, начиная с нуля).

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

Указатель на строку значения с индексами (Line,Col) во внутренней памяти объекта. Вызывающая программа не должна изменять эту строку. Если значения с такими номерами строки и столбца нет в тексте, функция возвращает указатель на пустую строку. Результатом возврата этой функции не может быть NULL, поэтому его можно использовать в любых строковых функциях без дополнительных проверок.

Примечания

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

Пример

Пример использования функции rdsCSVGetItem приведен в §2.16.2 руководства программиста.

См. также

rdsCSVCreate, rdsCSVSetItem, RDS_CSV_LINECOUNT, RDS_CSV_MAXCOLUMNS.