Source for file for.php

Documentation is available at for.php

  1. <?php
  2.  
  3. /**
  4.  * Similar to the php for block
  5.  * <pre>
  6.  *  * name : foreach name to access it's iterator variables through {$.foreach.name.var} see {@link http://wiki.dwoo.org/index.php/IteratorVariables} for details
  7.  *  * from : array to iterate from (which equals 0) or a number as a start value
  8.  *  * to : value to stop iterating at (equals count($array) by default if you set an array in from)
  9.  *  * step : defines the incrementation of the pointer at each iteration
  10.  *  * skip : allows you to skip some entries at the start, mostly useless excepted for smarty compatibility
  11.  * </pre>
  12.  * This software is provided 'as-is', without any express or implied warranty.
  13.  * In no event will the authors be held liable for any damages arising from the use of this software.
  14.  *
  15.  * This file is released under the LGPL
  16.  * "GNU Lesser General Public License"
  17.  * More information can be found here:
  18.  * {@link http://www.gnu.org/copyleft/lesser.html}
  19.  *
  20.  * @author     Jordi Boggiano <[email protected]>
  21.  * @copyright  Copyright (c) 2008, Jordi Boggiano
  22.  * @license    http://www.gnu.org/copyleft/lesser.html  GNU Lesser General Public License
  23.  * @link       http://dwoo.org/
  24.  * @version    0.9.1
  25.  * @date       2008-05-30
  26.  * @package    Dwoo
  27.  */
  28. class Dwoo_Plugin_for extends Dwoo_Block_Plugin implements Dwoo_ICompilable_Block
  29. {
  30.     public static $cnt=0;
  31.  
  32.     public function init($name, $from, $to=null, $step=1, $skip=0)
  33.     {
  34.     }
  35.  
  36.     public static function preProcessing(Dwoo_Compiler $compiler, array $params, $prepend, $append, $type)
  37.     {
  38.         $params = $compiler->getCompiledParams($params);
  39.         $tpl = $compiler->getTemplateSource(true);
  40.  
  41.         // assigns params
  42.         $from = $params['from'];
  43.         $name = $params['name'];
  44.         $step = $params['step'];
  45.         $skip = $params['skip'];
  46.         $to = $params['to'];
  47.  
  48.          // evaluates which global variables have to be computed
  49.         $varName = '$dwoo.for.'.trim($name, '"\'').'.';
  50.         $shortVarName = '$.for.'.trim($name, '"\'').'.';
  51.         $usesAny = strpos($tpl, $varName) !== false || strpos($tpl, $shortVarName) !== false;
  52.         $usesFirst = strpos($tpl, $varName.'first') !== false || strpos($tpl, $shortVarName.'first') !== false;
  53.         $usesLast = strpos($tpl, $varName.'last') !== false || strpos($tpl, $shortVarName.'last') !== false;
  54.         $usesIndex = strpos($tpl, $varName.'index') !== false || strpos($tpl, $shortVarName.'index') !== false;
  55.         $usesIteration = $usesFirst || $usesLast || strpos($tpl, $varName.'iteration') !== false || strpos($tpl, $shortVarName.'iteration') !== false;
  56.         $usesShow = strpos($tpl, $varName.'show') !== false || strpos($tpl, $shortVarName.'show') !== false;
  57.         $usesTotal = $usesLast || strpos($tpl, $varName.'total') !== false || strpos($tpl, $shortVarName.'total') !== false;
  58.  
  59.         // gets foreach id
  60.         $cnt = self::$cnt++;
  61.  
  62.         // builds pre processing output for
  63.         $out = Dwoo_Compiler::PHP_OPEN . "\n".'$_for'.$cnt.'_from = $_for'.$cnt.'_src = '.$from.';'.
  64.                                         "\n".'$_for'.$cnt.'_to = '.$to.';'.
  65.                                         "\n".'$_for'.$cnt.'_step = abs('.$step.');'.
  66.                                         "\n".'$_for'.$cnt.'_skip = abs('.$skip.');'.
  67.                                         "\n".'if (is_numeric($_for'.$cnt.'_from) && !is_numeric($_for'.$cnt.'_to)) { $this->triggerError(\'For requires the <em>to</em> parameter when using a numerical <em>from</em>\'); }';
  68.         // adds foreach properties
  69.         if ($usesAny) {
  70.             $out .= "\n".'$this->globals["for"]['.$name.'] = array'."\n(";
  71.             if ($usesIndex) $out .="\n\t".'"index"        => 0,';
  72.             if ($usesIteration) $out .="\n\t".'"iteration"        => 1,';
  73.             if ($usesFirst) $out .="\n\t".'"first"        => null,';
  74.             if ($usesLast) $out .="\n\t".'"last"        => null,';
  75.             if ($usesShow) $out .="\n\t".'"show"        => ($this->isArray($_for'.$cnt.'_from, true)) || (is_numeric($_for'.$cnt.'_from) && $_for'.$cnt.'_from != $_for'.$cnt.'_to),';
  76.             if ($usesTotal) $out .="\n\t".'"total"        => $this->isArray($_for'.$cnt.'_from) ? count($_for'.$cnt.'_from) - $_for'.$cnt.'_skip : (is_numeric($_for'.$cnt.'_from) ? abs(($_for'.$cnt.'_to + 1 - $_for'.$cnt.'_from)/$_for'.$cnt.'_step) : 0),';
  77.             $out.="\n);\n".'$_for'.$cnt.'_glob =& $this->globals["for"]['.$name.'];';
  78.         }
  79.         // checks if foreach must be looped
  80.         $out .= "\n".'if ($this->isArray($_for'.$cnt.'_from, true) || (is_numeric($_for'.$cnt.'_from) && abs(($_for'.$cnt.'_from - $_for'.$cnt.'_to)/$_for'.$cnt.'_step) !== 0))'."\n{";
  81.         // iterates over keys
  82.         $out .= "\n\t".'if ($this->isArray($_for'.$cnt.'_from, true)) {
  83.         $_for'.$cnt.'_from = 0;
  84.         $_for'.$cnt.'_to = is_numeric($_for'.$cnt.'_to) ? $_for'.$cnt.'_to - $_for'.$cnt.'_step : count($_for'.$cnt.'_src)-1;
  85.     }
  86.     $_for'.$cnt.'_keys = array();
  87.     if (($_for'.$cnt.'_from + $_for'.$cnt.'_skip) <= $_for'.$cnt.'_to) {
  88.         for ($tmp=($_for'.$cnt.'_from + $_for'.$cnt.'_skip); $tmp <= $_for'.$cnt.'_to; $tmp += $_for'.$cnt.'_step)
  89.             $_for'.$cnt.'_keys[] = $tmp;
  90.     } else {
  91.         for ($tmp=($_for'.$cnt.'_from - $_for'.$cnt.'_skip); $tmp > $_for'.$cnt.'_to; $tmp -= $_for'.$cnt.'_step)
  92.             $_for'.$cnt.'_keys[] = $tmp;
  93.     }
  94.     foreach ($_for'.$cnt.'_keys as $this->scope['.$name.'])'."\n\t{";
  95.         // updates properties
  96.         if ($usesIndex) {
  97.             $out.="\n\t\t".'$_for'.$cnt.'_glob["index"] = $this->scope['.$name.'];';
  98.         }
  99.         if ($usesFirst) {
  100.             $out .= "\n\t\t".'$_for'.$cnt.'_glob["first"] = (string) ($_for'.$cnt.'_glob["iteration"] === 1);';
  101.         }
  102.         if ($usesLast) {
  103.             $out .= "\n\t\t".'$_for'.$cnt.'_glob["last"] = (string) ($_for'.$cnt.'_glob["iteration"] === $_for'.$cnt.'_glob["total"]);';
  104.         }
  105.         $out .= "\n/* -- for start output */\n".Dwoo_Compiler::PHP_CLOSE;
  106.  
  107.  
  108.         // build post processing output and cache it
  109.         $postOut = Dwoo_Compiler::PHP_OPEN . '/* -- for end output */';
  110.         // update properties
  111.         if ($usesIteration) {
  112.             $postOut.="\n\t\t".'$_for'.$cnt.'_glob["iteration"]+=1;';
  113.         }
  114.         // end loop
  115.         $postOut .= "\n\t}\n}\n";
  116.  
  117.         // get block params and save the post-processing output already
  118.         $currentBlock =& $compiler->getCurrentBlock();
  119.         $currentBlock['params']['postOutput'] = $postOut . Dwoo_Compiler::PHP_CLOSE;
  120.  
  121.         return $out;
  122.     }
  123.  
  124.     public static function postProcessing(Dwoo_Compiler $compiler, array $params, $prepend, $append, $content)
  125.     {
  126.         return $content . $params['postOutput'];
  127.     }
  128. }

Documentation generated on Sun, 03 Aug 2008 15:12:35 +0200 by phpDocumentor 1.4.0