${ } (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.