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

Описания RDS

Приложения

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

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

А.5.2. Управление работой RDS и функции общего назначения

А.5.2.20. rdsFindCmdParam – найти номер параметра командной строки

# Приложения

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

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

#### А.5.2. Управление работой RDS и функции общего назначения

##### А.5.2.20. rdsFindCmdParam – найти номер параметра командной строки

Функция rdsFindCmdParam ищет в командной строке запуска RDS параметр с заданным именем и возвращает его порядковый номер.

      int RDSCALL rdsFindCmdParamA(
        RDSCSTR Param,     // Текст параметра (UTF8)
        BOOL CaseSensitive // Искать с учетом регистра
      );
      int RDSCALL rdsFindCmdParamW(
        RDSWCSTR Param,    // Текст параметра (UTF16)
        BOOL CaseSensitive // Искать с учетом регистра
      );
      // Функция-псевдоним
      int RDSCALL rdsFindCmdParam(
        RDSXCSTR Param,    // Текст параметра (кодировка по умолчанию)
        BOOL CaseSensitive // Искать с учетом регистра
      );

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

RDS_ISB (для UTF8) или RDS_IWsB (для UTF16)

Параметры

Param(RDSCSTR,RDSWCSTR,RDSXCSTR)
  Слово, которое нужно найти в командной строке.
CaseSensitive(BOOL)
  TRUE, если слово Param нужно искать с учетом регистра символов, FALSE в противном случае.

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

Порядковый номер слова в списке параметров, или −1, если такого слова не было в командной строке. Нумерация начинается с нуля.

Примечания

Функция rdsFindCmdParam работает с параметрами командной строки, использовавшейся для запуска RDS с одновременной загрузкой схемы, или со списком параметров, переданных в сервисную функцию rdsExecuteCommand для выполнения команд загрузки схемы RDS_SYSCMD_LOADFILE и RDS_SYSCMD_LOADTEMPLATE. Если схема загружена из пользовательского интерфейса RDS (например, при помощи пункта меню «файл | загрузить»), список параметров будет пустым.

Одним параметром командной строки считается либо слово, отделенное от остальных слов командной строки пробелами, либо текст, заключенный в двойные кавычки. В список, доступный сервисным функциям, попадают только параметры командной строки, не разобранные RDS. Например, слово «/run», указывающее RDS, что в загруженной схеме необходимо немедленно запустить расчет, в этот список не попадет, так же как и само имя файла загружаемой схемы.

См. также

Сервисные функции со строковыми параметрами и результатом, rdsGetCmdParamCount, rdsGetCmdParam, параметры командной строки RDS.