Элемент <unnamed>

Элемент <unnamed>

С помощью элементов <unnamed> можно описывать (документировать) безымянные параметры командной строки сценария. В табл. 3.2 приведено описание аргументов элемента <unnamed>.

Таблица 3.2. Аргументы элемента <unnamed>

Информация, которая указывается для объявляемого в элементе <unnamed> параметра командной строки, используется, как и в случае элемента <named>, только для самодокументируемости сценария и никак не влияет на реальные значения, которые будут указаны в командной строке при запуске сценария. Например, если безымянный параметр объявлен как обязательный (required="true"), но в действительности не был указан при запуске сценария, то никакой ошибки во время работы не произойдет.

Рассмотрим в качестве примера сценарий unnamed.wsf, в который в качестве параметров командной строки должны передаваться расширения файлов, причем обязательно должны быть указаны хотя бы два таких расширения (листинг 3.4).

Для создания информации об использовании этого сценария создается элемент <unnamed> следующего вида:

<unnamed name="Расш" helpstring="Расширения файлов" many="true" required=2/>

После запуска с помощью wscript.exe в сценарии unnamed.wsf сначала вызывается метод WScript.Arguments.Usage, в результате чего на экран выводится диалоговое окно с информацией о сценарии и параметрах командной строки (рис. 3.4).

Рис. 3.4. Диалоговое окно с информацией о параметрах сценария unnamed.wsf

Затем в сценарии создается коллекция objUnnamedArgs (объект WshUnnamed), которая содержит все безымянные аргументы командной строки, реально переданные в сценарий:

objUnnamedArgs=WScript.Arguments.Unnamed; //Создаем объект WshUnnamed

После этого определяется общее число реально переданных в сценарий параметров командной строки (свойство length) и в цикле while организуется перебор всех элементов коллекции objUnnamedArgs.

//Определяем количество безымянных аргументов

s="Передано в сценарий безымянных аргументов: "+objUnnamedArgs.length;

for (i=0; i<=objUnnamedArgs.length-1; i++)

 //Формируем строки со значениями безымянных аргументов

 s+=" "+objUnnamedArgs(i);

//Выводим полученные строки на экран

WScript.Echo(s);

Если запустить сценарий unnamed.wsf следующим образом:

wscript.exe unnamed.wsf vbs js

то на экран будет выведено диалоговое окно, показанное на рис. 3.5.

Рис. 3.5. Значения безымянных аргументов командной строки, переданных в unnamed.wsf

Листинг 3.4. Файл unnamed.wsf

<job id="Unnamed">

 <runtime>

  <description>

  Имя: unnamed.wsf

  Кодировка: Windows

  </description>

  <unnamed name="Расш" helpstring="Расширения файлов" many="true" required="2"/>

 </runtime>

 <script language="JScript">

 var objUnnamedArgs,s;

 //Вызываем метод ShowUsage для вывода на экран описания сценария

 WScript.Arguments.ShowUsage();

 objUnnamedArgs=WScript.Arguments.Unnamed;  //Создаем объект WshUnnamed

 //Определяем количество безымянных аргументов

 s="Передано в сценарий безымянных аргументов: "+objUnnamedArgs.length;

 for (i=0; i<=objUnnamedArgs.length-1; i++)

  //Формируем строки со значениями безымянных аргументов

  s+=" "+objUnnamedArgs(i);

 //Выводим полученные строки на экран

 WScript.Echo(s);

 </script>

</job>