Example #1
0
 /**
  * Lisää määrite-taulukkoon määritteen niin, että jos kyseinen määrite
  * siellä jo on, sen arvo muutetaan. Muuten lisätään uusi määrite.
  * Palauttaa määritetaulukon.
  * 
  * <p>Ellei määrite-taulukko ole määritelty taulukko, luodaan sen sijaan
  * uusi tyhjä taulukko.</p>
  * 
  * <p>Ellei $uusi ole Maarite-luokan olio, ei tehdä mitään!</p>
  * 
  * <p>Jos määrite on parametrillinen js-metodi (onclick, 
  * onmouseover tms.) muutetaan mahdollisesta jo olemassaolevasta 
  * määritteestä arvon (metodin nimen) lisäksi myös metodin parametrit
  * (taulukko).</p>
  * 
  * <p>HUOM! $maarite_array-parametrin edessä & -> muutokset siirtyvät 
  * suoraan taulukkoon.</p>
  * 
  * @param Maarite $uusi
  * @param type $maarite_array
  * @return type array Palauttaa muokatun $maarite_array-taulukon.
  */
 static function lisaa_maarite($uusi, &$maarite_array)
 {
     $koodi = Maarite::$EI_LOYTYNYT;
     if ($uusi instanceof Maarite) {
         // is_array palauttaa falsen, jos parametri null.
         if (!is_array($maarite_array)) {
             $maarite_array = array();
         } else {
             foreach ($maarite_array as $maariteolio) {
                 if ($maariteolio instanceof Maarite) {
                     // Jos määrite löytyi, muutetaan sitä:
                     if ($maariteolio->get_nimi() == $uusi->get_nimi()) {
                         // muutetaan arvo:
                         $maariteolio->set_arvo($uusi->get_arvo());
                         // JS-tapauksessa myös parametrit:
                         if ($uusi->on_js_metodi() && $maariteolio->on_js_metodi()) {
                             $maariteolio->set_js_parametrit($uusi->get_js_parametrit());
                         }
                         $koodi = "loytyipa";
                     }
                 }
             }
         }
         // Liitetään uusi taulukkoon, ellei löytynyt.
         if ($koodi === Maarite::$EI_LOYTYNYT) {
             // Lisätään määrite taulukkoon:
             array_push($maarite_array, $uusi);
         }
     }
     return $maarite_array;
 }