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

Описания RDS

Приложения

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

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

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

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

# Приложения

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