separate_arguments

Разделить аргументы командной строки в список, разделённый точкой с запятой.

separate_arguments(<variable> <mode> [PROGRAM [SEPARATE_ARGS]] <args>)

Парсит строку, разделённую пробелами <args> в список элементов и сохраняет этот список в стандартном формате, разделённом точкой с запятой, в <variable>.

Эта функция предназначена для парсинга аргументов командной строки. Вся командная строка должна быть передана как одна строка в аргументе <args>.

Точные правила парсинга зависят от операционной системы. Они определяются аргументом <mode> , который должен быть одним из следующих ключевых слов:

UNIX_COMMAND

Аргументы разделены необработанными пробелами. Оба типа пар кавычек (одинарные и двойные) учитываются. Обратная косая черта экранирует следующий литеранный символ (\" — это "); нет специальных экранирований (\n — это просто n).

WINDOWS_COMMAND

Командная строка Windows парсится с использованием того же синтаксиса, который использует библиотека выполнения для построения argv при запуске. Она разделяет аргументы пробелами, которые не заключены в двойные кавычки. Обратные косые черты являются буквальными, за исключением случаев, когда они предшествуют двойным кавычкам. Подробнее см. статью MSDN Parsing C Command-Line Arguments.

NATIVE_COMMAND

Новое в версии 3.9.

Действует так же, как в режиме WINDOWS_COMMAND , если хост-система Windows. В противном случае действует так же, как в режиме UNIX_COMMAND.

PROGRAM

Новое в версии 3.19.

Первый элемент в <args> предполагается, что это исполняемый файл, и он будет искаться в пути поиска системы или оставлен как полный путь. Если не найден, <variable> будет пустым. В противном случае, <variable> представляет собой список из 2 элементов:

0. Абсолютный путь к программе
1. Любые аргументы командной строки, присутствующие в <args> в виде строки

Например:

separate_arguments (out UNIX_COMMAND PROGRAM "cc -c main.c")

• Первый элемент списка: /path/to/cc
• Второй элемент списка: " -c main.c"

SEPARATE_ARGS

Когда этот подвариант опции PROGRAM указан, аргументы командной строки также будут разделены и сохранены в <variable>.

Например:

separate_arguments (out UNIX_COMMAND PROGRAM SEPARATE_ARGS "cc -c main.c")

Содержание out будет: /path/to/cc;-c;main.c

separate_arguments(<var>)

Преобразовать значение <var> в список, разделённый точкой с запятой. Все пробелы заменяются на «;». Это помогает при генерации командных строк.