$FUNCNAME$
  AADD()
$CATEGORY$
  Array, Object
$SUMMARY$
   Add a new element to the end of an array
$LANG_RU$
        .
$LANG_HU$
    Hozzad egy elemet egy tmbhz.
$LANG_ES$
   Adiciona un elemento a una matriz
$LANG_PT$
   Adiciona um elemento a uma matriz
$LANG_UA$
      
$SYNTAX$
     AADD(<aTarget>, <expValue>[, <keyValue>]) --> Value
$LANG_RU$

     AADD(< >, <>[, <keyValue>]) --> 
$ARGUMENTS$
     <aTarget> is the array to which a new element is to be added.

     <expValue> is the value assigned to the new element.

     <keyValue> is the new element key value .

$LANG_RU$

     < > -  ,    
     .

     <> -  ,   .

     <keyValue>  -    .  
     ,       .
$LANG_HU$
   <aTarget> A tmb, amelyhez hozzadunk egy j elemet.

   <expValue> Az rtk, amelyet hozzadunk a tmbhz.

   <keyValue> Az j elem elrsi kulcsa (sorszma). Ha nincs megadva, akkor az j
   elem lesz a tmb utols eleme.

$LANG_ES$
   <aTarget> Matriz a la que se le a?ade un nuevo elemento

   <expValue> Valor que se a?ade a la matriz

   <keyValue> Es la posici?n del nuevo elemento. Si se omite el nuevo elemento se
   a?ade al final de la matriz

$LANG_PT$
  <aTarget>  Matriz onde ser adicionado o novo elemento

  <expValue> Valor que ser atribuido a matriz

  <keyValue>  a posio do novo elemento. Se no for especificada, o novo elemento
   ser acidionado no final da matriz

$LANG_UA$
   <aTarget> ,     .

   <expValue> ,  պ  .

   <keyValue> ó  ׳ <aTarget>,     .  
   ,   ˳ó .
$RETURNS$

     AADD() evaluates <expValue> and returns its value.  If <expValue> is not
     specified, AADD() returns NIL.
$LANG_RU$
     AADD  <>    . 
     <>  , AADD()  NIL.

$LANG_HU$
    Az AADD() fggvny kirtkeli a <expValue> rtkt s visszatr a hv
   helyre. A <expValue> rtk nincs meghatrozva, az AADD() NIL rtkkel
   tr vissza.

$LANG_ES$
   AADD() retorna <expValue>. Si se omite <expValue>  AADD() retorna NIL

$LANG_PT$
   AADD() retorna <expvalue>. Se for omitido <expvalue> AADD() retorna NIL

$LANG_UA$
   AADD() ó <expValue>,  ׳׳ ͳ <aTarget>   
<aTarget>.
     <expValue>  , AADD()  NIL.
$DESCRIPTION$

     AADD() is an array function that increases the actual length of the
     target array by one.  The newly created array element is assigned the
     value specified by <expValue>.

     AADD() is used to dynamically grow an array.  It is useful for building
     dynamic lists or queues.  A good example of this is the GetList array
     used by the Get system to hold Get objects.  After a READ or CLEAR GETS,
     GetList becomes an empty array.  Each time you execute an @...GET
     command, the Get system uses AADD() to add a new element to the end of
     the GetList array, and then assigns a new Get object to the new element.

     AADD() is similar to ASIZE() but only adds one element at a time;
     ASIZE() can grow or shrink an array to a specified size.  AADD(),
     however, has the advantage that it can assign a value to the new
     element, while ASIZE() cannot.  AADD() may also seem similar to AINS(),
     but they are different:  AINS() moves elements within an array, but it
     does not change the array's length.

     Note:  If <expValue> is another array, the new element in the target
     array will contain a reference to the array specified by <expValue>.


$LANG_RU$

     AADD() -    ,  
          .  
       ,   <>.

     AADD()     . 
           . 
        Getlist,   GET  
     GET- .   READ  CLEAR GETS, Getlist 
      .  ,    @...GET,
      GET   AADD()    
        Getlist     GET- 
     .

     AADD()   ASIZE(),      
     ; ASIZE()       
     .  AADD(), ,   ,  
        ,     ASIZE()
        .  AADD()      
     AINS(),   .  AINS()   
     ,       .

     .   <> -   ,    
           , 
      <>.

$LANG_HU$
    Az AADD() egy tmbkezel fggvny, amely eggyel megnveli a tmb
   aktulis hosszt. Az jonnan ltrejv elem a <expValue> rtke lesz.

$LANG_ES$
   AADD() es una funci?n que a?ade un elemento a la matriz dada. Al nuevo
   elemento creado se le asigna el valor especificado por <expValue>

$LANG_PT$
   AADD()  uma funo que adiciona um elemento a matriz informada. Ao novo
   elemento adicionado ser atribuido o valor especificado em  <expValue>

$LANG_UA$
   AADD() -  ó  ׳,  ³պ  
     .     <expValue>.
$EXAMPLES$

       These examples demonstrate the effects of multiple invocations
	of AADD() to an array:

	aArray := {}                  // Result: aArray is an empty array
	AADD(aArray, 5)               // Result: aArray is { 5 }
	AADD(aArray, 10)              // Result: aArray is { 5, 10 }
	AADD(aArray, { 12, 10 })      // Result: aArray is
				      // { 5, 10, { 12, 10 } }


$LANG_RU$

           
       AADD()  .

       aArray := {}           // : aArray -  
       AADD(aArray, 5)        // : aArray - { 5 }
       AADD(aArray, 10)       // : aArray - {5,10}
       AADD(aArray, {12,10})  // : aArray - {5,10,{12,10}}


$PECULIARITIES$
   AADD() can be take map as parametr <aTarget>. In this case <keyValue> it is
   hash key newly element.
   $LANG_RU$
   AADD()      < > .     <keyValue>
    -  .
   $LANG_HU$
   Az AADD() fggvny paramterknt kapja meg az <aTarget> tmbt. Ebben az
esetben az <keyValue> az j elem elrsi kulcsa (sorszma) lesz.
   $LANG_ES$
   AADD() puede recibir una variable de tipo "map", como par?metro <aTarget> .
	En este caso <keyValue> representa la clave "hash" del nuevo elemento
   $LANG_PT$
   AADD() pode receber uma variavel tipo "map", como parmetro <aTarget> .
   Neste caso, <keyValue> representa a clave "hash" do novo elemento
   $LANG_UA$
   AADD()    Գ  <aTarget> '.   
    <keyValue> ,  -  .
$PLATFORMS$
   No dependies of platform.
   $LANG_RU$
      
   $LANG_HU$
   Nincs platform fgg tulajdonsg.
   $LANG_ES$
   No es dependiente de la plataforma
   $LANG_PT$
   No  dependente de plataforma
   $LANG_UA$
     ׳ .
$SEEALSO$
  AINS(),ASIZE(),
$AUTHOR$
ITK
   $LANG_RU$

   $LANG_HU$
ITK
   $LANG_ES$
ITK
$LANG_PT$
Nogueira, nogueira_jr@ig.com.br
   $LANG_UA$
    
$END$
