Приложения

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