Serj Kalichev 1 year ago
parent
commit
8c7e30285f
1 changed files with 31 additions and 0 deletions
  1. 31 0
      docs/klish3.ru.md

+ 31 - 0
docs/klish3.ru.md

@@ -1245,6 +1245,37 @@ SEQ сам может быть элементом контейнера SWITCH.
 
 #### Атрибуты `min` и `max`
 
+Атрибуты `min` и `max` используются в элементе `PARAM` и определяют сколько
+аргументов, введенных оператором, могут быть сопоставлены текущему параметру.
+
+Атрибут `min` определяет минимальное количество аргументов, которые должны
+соответствовать параметру, т.е. должны пройти проверку на корректность
+относительно типа данных этого параметра. Если `min="0"`, то параметр
+становится опциональным. Т.е. если он не введен, то это не является ошибкой.
+По умолчанию принимается `min="1"`.
+
+Атрибут `max` определяет максимальное количество однотипных аргументов, которые
+могут быть сопоставлены параметру. Если оператор вводит большее количество
+аргументов, чем задано в атрибуте `max`, то эти аргументы не будут проверяться
+на соответствие текущему параметру, но могут проверяться на соответствие
+другим параметрам, определенным после текущего. По умолчанию принимается
+`max="1"`.
+
+Атрибут `min="0"` может использоваться в элементе `COMMAND`, чтобы объявить
+подкоманду опциональной.
+
+```
+<PARAM name="param1" ptype="/INT" min="0"/>
+<PARAM name="param2" ptype="/INT" min="3" max="3"/>
+<PARAM name="param3" ptype="/INT" min="2" max="5"/>
+<COMMAND name="subcommand" min="0"/>
+```
+
+В примере параметр "param1" объявлен опциональным. Параметру "param2" должно
+соответствовать ровно три аргумента, введенных оператором. Параметру "param3"
+могут соответствовать от двух до пяти аргументов. Подкоманда "subcommand"
+объявлена опциональной.
+
 
 ### VIEW