declare (beépített Bash parancs)

Tartalom

 

Adatok

Verziószám: GNU bash, 4.4.12
Fejlesztő/tulajdonos: Free Software Foundation, Inc.

 

 

Manual oldal

man bash
[...]
       declare [-aAfFgilnrtux] [-p] [name[=value] ...]
       typeset [-aAfFgilnrtux] [-p] [name[=value] ...]
              Declare variables and/or give them attributes.  If no names are given then  display
              the  values  of variables.  The -p option will display the attributes and values of
              each name.  When -p is used with name arguments, additional options, other than  -f
              and  -F,  are ignored.  When -p is supplied without name arguments, it will display
              the attributes and values of all variables having the attributes specified  by  the
              additional options.  If no other options are supplied with -p, declare will display
              the attributes and values of all shell variables.  The -f option will restrict  the
              display to shell functions.  The -F option inhibits the display of function defini-
              tions; only the function name and attributes are printed.  If  the  extdebug  shell
              option is enabled using shopt, the source file name and line number where each name
              is defined are displayed as well.  The -F option implies -f.  The -g option  forces
              variables  to be created or modified at the global scope, even when declare is exe-
              cuted in a shell function.  It is ignored in all other cases.   The  following  op-
              tions  can  be used to restrict output to variables with the specified attribute or
              to give variables attributes:
              -a     Each name is an indexed array variable (see Arrays above).
              -A     Each name is an associative array variable (see Arrays above).
              -f     Use function names only.
              -i     The variable is treated as an integer; arithmetic evaluation (see ARITHMETIC
                     EVALUATION above) is performed when the variable is assigned a value.
              -l     When  the  variable  is assigned a value, all upper-case characters are con-
                     verted to lower-case.  The upper-case attribute is disabled.
              -n     Give each name the nameref attribute, making it a name reference to  another
                     variable.   That other variable is defined by the value of name.  All refer-
                     ences, assignments, and attribute modifications to name, except those  using
                     or  changing  the  -n attribute itself, are performed on the variable refer-
                     enced by name's value.  The nameref attribute cannot  be  applied  to  array
                     variables.
              -r     Make  names  readonly.  These names cannot then be assigned values by subse-
                     quent assignment statements or unset.
              -t     Give each name the trace attribute.  Traced functions inherit the DEBUG  and
                     RETURN  traps  from  the  calling shell.  The trace attribute has no special
                     meaning for variables.
              -u     When the variable is assigned a value, all lower-case  characters  are  con-
                     verted to upper-case.  The lower-case attribute is disabled.
              -x     Mark names for export to subsequent commands via the environment.

              Using  `+' instead of `-' turns off the attribute instead, with the exceptions that
              +a and +A may not be used to destroy array variables and +r  will  not  remove  the
              readonly  attribute.   When  used in a function, declare and typeset make each name
              local, as with the local command, unless the -g option is supplied.  If a  variable
              name  is followed by =value, the value of the variable is set to value.  When using
              -a or -A and the compound assignment syntax to create array  variables,  additional
              attributes  do not take effect until subsequent assignments.  The return value is 0
              unless an invalid option is encountered, an attempt is made to  define  a  function
              using  ``-f foo=bar'', an attempt is made to assign a value to a readonly variable,
              an attempt is made to assign a value to an array variable without  using  the  com-
              pound  assignment  syntax (see Arrays above), one of the names is not a valid shell
              variable name, an attempt is made to turn off readonly status for a readonly  vari-
              able,  an attempt is made to turn off array status for an array variable, or an at-
              tempt is made to display a non-existent function with -f.
[...]

 

 

Súgó kimenet

declare --help
declare: declare [-aAfFgilnrtux] [-p] [név[=érték] ...]
    Változóértékek és attribútumok beállítása.
    
    Változók deklarálása és attribútumok megadása. Ha nincs NÉV megadva,
    kiírja az összes változó attribútumait és értékét.
    
    Kapcsolók:
      -f        művelet és megjelenítés korlátozása függvénynevekre és
                -definíciókra
      -F        megjelenítés korlátozása függvénynevekre (és sor számára,
                valamint a forrásfájl nevére hibakereséskor)
      -g        globális változók létrehozása parancsértelmező-függvényben való
                használatkor, egyébként figyelmen kívül marad
      -p        minden NÉV attribútumainak és értékének kiírása
    
    Attribútumokat állító kapcsolók:
      -a        NÉV indexelt tömbbé alakítása (ha támogatott)
      -A        NÉV asszociatív tömbbé alakítása (ha támogatott)
      -i        minden NÉV kapjon „integer” attribútumot
      -l        a NÉV kisbetűssé konvertálása értékadáskor
      -n        a NÉV hivatkozás legyen az értékében megadott változóra
      -r        minden NÉV legyen csak olvasható
      -t        minden NÉV kapjon „trace” attribútumot
      -u        a NÉV nagybetűssé konvertálása értékadáskor
      -x        minden NÉV exportálása
    
    A „-” helyett „+” használata kikapcsolja az adott attribútumot.
    
    Az integer attribútummal rendelkező változókhoz való értékadáskor
    aritmetikai kiértékelés történik (lásd a „let” parancsot).
    
    Függvénytörzsben „declare”-t használva minden NÉV helyi lesz, hasonlóan
    a „local” parancshoz. A „-g” kapcsoló elnyomja ezt a viselkedést.
    
    Kilépési kód:
    Sikerrel tér vissza, kivéve ha érvénytelen kapcsolót kap, vagy értékadási
    hiba történik.

 

Kapcsolódó tartalom

  • ...

 

Címkék