.. currentmodule:: TatInternalObject

TbtkNamedArgs
----------------------------------------------------------------------

.. pas:class:: TbtkNamedArgs

  Коллекция аргументов

  .. pas:method:: Exists(Name: String): Boolean

    Метод проверяет существование в коллекции аргумента с заданным именем.

    :param String Name:
      Имя аргумента

    :rtype: Boolean

    .. code-block:: delphi
      :caption: Пример использования

      <Pascal args>
        if not args.Exists('A') then
          ShowMessage('Argument "A" does not exists.');
      </Pascal>


  .. pas:method:: SetDefaults(NameValues: Array)

    Устанавливает заданные значения аргументов для отсутствующих или неинициализированных аргументов.

    :param Array NameValues:
      чередующийся массив имён и значений аргументов имеющий следующий вид:
      [Имя, Значение, Имя, Значение]

    .. code-block:: delphi
      :caption: Пример использования

      <Pascal args>
        // Проверяем список переданных аргументов, а предмет передачи лишних аргументов.
        args.SetDefaults(['A', 1, 'B', 2, 'C', 3]);
        ShowMessage('Вызван метод "TestOperation" из библиотеки "SEL_ClientLibraryInstance"');
        Result := 'Результат вложенной функции.' + #13#10
          + ' A := ' + VarToStr(args.A) + #13#10
          + ' B := ' + VarToStr(args.B) + #13#10
          + ' C := ' + VarToStr(args.C) + #13#10;
      </Pascal>


  .. pas:method:: Validate(Names: Array)

    Метод проверяет коллекцию переданных аргументов на соответствие списку
    ожидаемых аргументов. Если переданная коллекция будет иметь аргумент, не
    упомянутый в списке ожидаемых, будет сгенерирована ошибка.

    :param Array Names:
      Массив строк, с именами ожидаемых аргументов

    .. code-block:: delphi
      :caption: Пример использования

      <Pascal args>
        // Проверяем список переданных аргументов, на предмет передачи лишних аргументов.
        args.Validate(['A','B','C']);
        ShowMessage('Вызван метод "TestOperation" из библиотеки "SEL_ClientLibraryInstance"');
        Result := 'Результат вложенной функции.' + #13#10
          + ' A := ' + VarToStr(args.A) + #13#10
          + ' B := ' + VarToStr(args.B) + #13#10
          + ' C := ' + VarToStr(args.C) + #13#10;
      </Pascal>