Compartilhar via


${ } (Interpretador de Alias)

Um sinal de dólar seguido por um par de chaves ( ${ } ) é avaliado como uma variedade de valores relacionados ao alias nomeado pelo usuário especificado.

Text ${Alias} Text 
Text ${/d:Alias} Text 
Text ${/f:Alias} Text 
Text ${/n:Alias} Text 
Text ${/v:Alias} Text 

Parâmetros

Alias

Especifica o nome do alias a ser expandido ou avaliado. O alias deve ser um alias nomeado pelo usuário ou o valor Variável usado pelo token .foreach .

/d

É avaliado como um ou zero, dependendo se o alias está definido no momento. Se o alias for definido, ${/d:Alias} será substituído por 1; se o alias não estiver definido, ${/d:Alias} será substituído por 0.

/f

Avaliará para o alias equivalente se o alias estiver definido no momento. Se o alias for definido, ${/f:Alias} será substituído pelo alias equivalente; se o alias não estiver definido, ${/f:Alias} será substituído por uma cadeia de caracteres vazia.

/n

Avaliará o nome do alias se o alias estiver definido no momento. Se o alias for definido, ${/n:Alias} será substituído pelo nome do alias; se o alias não estiver definido, não será substituído, ${/n:Alias} mas manterá seu valor literal de ${/n:Alias}.

/v

Impede qualquer avaliação de alias. Independentemente de o Alias ser definido, ${/v:Alias} sempre mantém seu valor literal de ${/v:Alias}.

Informações adicionais

Para obter uma explicação de como usar aliases, consulte Usando aliases.

Comentários

Se nenhuma opção for usada e o alias estiver definido no momento, ${Alias} será substituído pelo alias equivalente. Se nenhuma opção for usada e o alias não estiver definido, ${Alias} sempre manterá seu valor literal de ${Alias}.

Uma vantagem de usar o token ${ } é que o alias será avaliado mesmo que seja adjacente a outros caracteres. Sem esse token, o depurador substitui apenas os aliases separados de outros tokens por um espaço.

Conforme indicado, há circunstâncias em que o token ${ } não é substituído por nada, mas retém seu valor literal. Isso ocorre quando nenhuma opção é usada e o Alias é indefinido, quando a opção /n é usada e o Alias é indefinido e sempre quando a opção /v é usada. Nessas circunstâncias, o token retém seu valor literal, incluindo o cifrão e as chaves. Portanto, se isso for usado como o parâmetro de um comando, ocorrerá um erro de sintaxe, a menos que esse parâmetro aceite cadeias de caracteres de texto arbitrárias.

No entanto, há uma exceção a isso. Se você usar ${/v:Alias} como o primeiro parâmetro para o comando as (Set Alias) ou aS (Set Alias), esse token será tratado apenas como o Alias da cadeia de caracteres, não como a cadeia de caracteres ${/v:Alias}. Isso só funciona com os comandos as, aS e ad e só funciona quando o comutador /v é usado— ele não funcionará com ${/n:Alias} ou ${Alias} quando eles mantiverem seus valores literais.

O alias deve ser um alias nomeado pelo usuário ou o valor Variável usado pelo token .foreach , não um alias de nome fixo. Se houver um alias de nome fixo dentro do Alias da cadeia de caracteres, ele será substituído antes que o token ${ } seja avaliado.