Comando Bash declare builtin

Nos sistemas operacionais do tipo Unix, declare é um comando interno do shell Bash . Declara variáveis e funções do shell, define seus atributos e exibe seus valores .

Descrição

No bash, as variáveis ​​podem ter um valor (como o número 3 ). Opcionalmente, também é possível atribuir variáveis ​​às variáveis ​​(como número inteiro ).

Por exemplo, uma variável ” somente leitura ” ( declarar -r ) não pode ser desabilitada e seu valor e outros atributos não podem ser modificados. Uma variável “matriz indexada” ( declarar -a ) é uma matriz de valores indexados por número, começando em zero. Uma variável “matriz associativa” ( declarar -A ) é uma matriz de pares de valores-chave cujos valores são indexados por uma palavra-chave. (Para mais informações, consulte matrizes no bash ).

Além das variáveis, as funções bash podem receber atributos que afetam seu comportamento. Consulte as opções -f e -F abaixo para obter mais informações.

Sintaxe

  declarar [ -a ] [ -A ] [ -f ] [ -F ] [ -g ] [ -i ] [ -l ] [ -n ] [ -r ]
         [ -t ] [ -u ] [ -x ] [ -p ] [ nome [ = valor ]] [ nome [ = valor ]] ...

Opções

O comando declare builtin utiliza as seguintes opções gerais:

As opções restantes, listadas abaixo, fazem com que declarem definir um atributo se a letra da opção for precedida por um traço. Se precedido por um sinal de mais, declare irá desabilitar o atributo.

Âmbito lexical

Quando declare é usado dentro de uma função shell, todos os itens nomeados são declarados em um escopo local, a menos que a opção -g seja usada. Esse comportamento é o mesmo que usar o comando interno local .

Status de saída

O status de saída de declare é bem-sucedido (zero), a menos que uma opção inválida seja especificada ou ocorra um erro durante a atribuição de variáveis. Nesse caso, o status é falha (diferente de zero).

Exemplos

Declarando e listando variáveis

  declarar -p

Liste todas as variáveis ​​declaradas, seus atributos e seus valores.

  declarar myvar

Declare uma variável myvar e não atribua valor a ela. Agora execute o primeiro comando novamente:

  declarar -p

Desta vez, observe na saída que myvar está listado após todas as outras variáveis ​​como:

  declarar - myvar

O traço duplo é equivalente a “sem opções”. Isso significa que myvar é declarado e não possui atributos. Se tivesse um valor atribuído, o valor seria listado aqui.

  myvar = 33

Atribua o valor 33 a myvar .

  declarar myvar = 33

O mesmo que o comando acima.

  declarar - myvar = 33

O mesmo que os dois comandos acima.

  declarar - myvar = "33"

O mesmo que os três comandos acima; esta é a forma correta, incluindo o valor entre aspas duplas. No entanto, qualquer um dos quatro comandos acima tem o mesmo efeito.

Agora, liste todas as variáveis ​​novamente:

  declarar -p

Você verá que, desta vez, a saída lista myvar com sua atribuição de valor:

  declarar - myvar = "33"

O principal a ser observado aqui é que, quando você executa declare -p , as variáveis ​​são listadas como o comando declare completo, de que você precisaria definir a variável para seus atributos e valor atuais.

Configurando e Desativando Atributos

Os próximos comandos modificam os atributos da variável:

  declarar -x myvar

Declare que myvar deve ser exportado para qualquer processo de shell filho. Isso é equivalente ao uso do comando export :

  exportar myvar

Agora, liste as declarações de variáveis:

  declarar -p

Observe que na saída, o traço duplo (sem opções) foi substituído por -x :

  declarar -x myvar = "33"

Para remover o atributo de exportação, use + x :

  declarar + x myvar

Após executar o comando acima, o myvar não será mais exportado para processos de subcasca.

Inteiros e avaliação inteira

O Bash permite que você declare uma variável como tendo o atributo inteiro , o que garante que a variável sempre mantenha um valor inteiro. Também permite a avaliação aritmética ao atribuir um valor.

  declarar -i myvar

Declare que myvar deve ser tratado como um número inteiro.

  myvar = "teste"

A sequência ” test ” é um valor não inteiro, portanto, o valor 0 (zero) é atribuído. Você pode verificar isso se ecoar o valor:

  echo $ myvar

  0 0

Qualquer valor inteiro positivo ou negativo pode ser atribuído. (O valor máximo possível depende do seu computador, mas é enorme):

  myvar = -33;  echo $ myvar

  -33

Se uma sequência contendo uma operação aritmética for atribuída a uma variável inteira, o resultado da operação será atribuído. Por exemplo:

  myvar = "2 * 11";  echo $ myvar

  22

O comando acima atribui myvar o valor de 2 vezes 11 .

Se a operação matemática resultar em um número com um ponto decimal, o resultado será arredondado para o próximo número inteiro mais baixo. Por exemplo:

  myvar = "33/5";  echo $ myvar

  6

O resultado preciso de 33 dividido por 5 ( 33/5 ) é 6,6 , mas o bash o arredonda para o número inteiro 6 .

Se você tentar usar valores decimais como operandos , o bash retornará um erro, informando que o ponto decimal é um operador desconhecido:

  myvar = "33,1 / 5";  echo $ myvar

  bash: 33.1 / 5: erro de sintaxe: operador aritmético inválido (o token de erro é ".1 / 5")

Para desarmar o atributo inteiro, use a opção + i :

  declarar + i myvar

Agora, myvar não tem mais o atributo inteiro . Strings contendo operações matemáticas serão agora atribuídas a myvar literalmente , em vez de avaliadas . Por exemplo:

  myvar = "33,1 / 5";  echo $ myvar

  33.1 / 5

Matrizes indexadas

Para declarar uma matriz indexada, use -a :

  declarar -a myvar

Se myvar já tiver um valor atribuído, esse valor será indexado como o primeiro elemento, numerado zero:

  eco $ {myvar [0]}

  33.1 / 5

Agora você pode atribuir valores a elementos da matriz myvar usando números inteiros como os índices:

  myvar [1] = "Olá"

  myvar [2] = "Mundo!"

Os elementos podem ser acessados ​​pelo número do índice usando a seguinte sintaxe:

  eco $ {myvar [2]}

  Mundo!

Se você usar um número inteiro negativo como índice, o bash contará a partir do último elemento, em vez do primeiro. Para acessar o último elemento, use o índice -1 :

  eco $ {myvar [-1]}

  Mundo!

Um índice de -2 acessaria o penúltimo elemento da matriz, etc .:

  eco $ {myvar [-2]}

  Olá

Para exibir todos os elementos em uma matriz, você pode usar um asterisco (” * “) como índice. Elementos individuais são separados por um espaço:

eco $ {myvar [*]}

  33.1 / 5 Olá Mundo!

  declarar + um myvar

  bash: declare: myvar: não pode destruir variáveis ​​de matriz desta maneira

Verifique se uma variável é declarada

Se você está escrevendo um script bash e precisa verificar se uma variável é declarada, esta é a maneira correta de fazê-lo:

  if [-z $ {myvar + x}];  então ecoa "não definido";  else echo "set";  fi

Isso executará a expansão do parâmetro “Atribuir valor alternativo” , que testa se myvar foi definido e se seu valor é nulo . Se myvar estiver desabilitado , ele ecoará ” não definido “. Caso contrário, ele ecoará ” set “. Observe que a letra x pode ser o que você quiser, mas é necessária para que a comparação ocorra.

Comandos relacionados

exportar – Marque variáveis ​​e funções a serem exportadas para processos filho.