Você está visualizando a documentação da versão de desenvolvimento, que pode estar incompleta.
Esta página foi traduzida automaticamente. Se você notar um erro, selecione-o e pressione Ctrl+Enter para reportá-lo aos editores.

1 Formato da chave do item

O formato da chave do item, incluindo os parâmetros da chave, deve seguir as regras de sintaxe. As ilustrações a seguir mostram a sintaxe suportada. Os elementos e caracteres permitidos em cada ponto podem ser determinados seguindo as setas - se algum bloco puder ser alcançado pela linha, ele é permitido, caso contrário, não é permitido.

Para construir uma chave de item válida, começa-se especificando o nome da chave, depois há a escolha de ter ou não parâmetros - conforme mostrado pelas duas linhas que podem ser seguidas.

Nome da chave

O próprio nome da chave possui um intervalo limitado de caracteres permitidos, que simplesmente seguem uns aos outros. Os caracteres permitidos são:

0-9a-zA-Z_-.

O que significa:

  • todos os números;
  • todas as letras minúsculas;
  • todas as letras maiúsculas;
  • sublinhado;
  • traço;
  • ponto.

Parâmetros de chave

Uma chave de item pode ter vários parâmetros separados por vírgulas.

Cada parâmetro de chave pode ser uma string entre aspas, uma string sem aspas ou um array.

O parâmetro também pode ser deixado em branco, usando assim o valor padrão. Nesse caso, o número apropriado de vírgulas deve ser adicionado se quaisquer outros parâmetros forem especificados. Por exemplo, a chave de item icmpping[,,200,,500] especificaria que o intervalo entre pings individuais é de 200 milissegundos, o tempo limite - 500 milissegundos, e todos os outros parâmetros permanecem com seus valores padrão.

É possível incluir macros nos parâmetros. Elas podem ser macros de usuário ou algumas das macros internas. Para ver quais macros internas específicas são suportadas nos parâmetros de chave de item, procure na página Macros suportadas por "item key parameters".

Parâmetro - string entre aspas

Se o parâmetro da chave for uma string entre aspas, qualquer caractere Unicode é permitido. Se a string do parâmetro da chave contiver uma aspa, esse parâmetro deverá ser colocado entre aspas e cada aspa que fizer parte da string do parâmetro deverá ser escapada com um caractere de barra invertida (\). Se a string do parâmetro da chave contiver vírgula, esse parâmetro deverá ser colocado entre aspas.

Para colocar parâmetros de chave de item entre aspas, use apenas aspas duplas. Aspas simples não são suportadas.

Arrays de parâmetros multinível, por exemplo, [a,[b,[c,d]],e], não são permitidos.

Parâmetro - string sem aspas

Se o parâmetro da chave for uma string sem aspas, qualquer caractere Unicode é permitido, exceto vírgula e colchete direito (]). O parâmetro sem aspas não pode começar com colchete esquerdo ([).

Parâmetro - array

Se o parâmetro da chave for um array, ele será novamente colocado entre colchetes, onde os parâmetros individuais seguem as regras e sintaxe de especificação de múltiplos parâmetros.