| <?php |
| /** |
| * File containing the ezcTemplateArrayFunctions class |
| * |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, |
| * software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| * KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations |
| * under the License. |
| * |
| * @package Template |
| * @version //autogen// |
| * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0 |
| * @access private |
| */ |
| |
| /** |
| * This class contains a bundle of static functions, each implementing a specific |
| * function used inside the template language. |
| * |
| * @package Template |
| * @version //autogen// |
| * @access private |
| */ |
| class ezcTemplateArrayFunctions extends ezcTemplateFunctions |
| { |
| /** |
| * Translates a function used in the Template language to a PHP function call. |
| * The function call is represented by an array with three elements: |
| * |
| * 1. The return typehint. It is an array, a non-array, or both. |
| * 2. The parameter input definition. |
| * 3. The AST nodes. |
| * |
| * @param string $functionName |
| * @param array(ezcTemplateAstNode) $parameters |
| * @return array(mixed) |
| */ |
| public static function getFunctionSubstitution( $functionName, $parameters ) |
| { |
| switch ( $functionName ) |
| { |
| // array_count( $a ) ( QList::count ):: |
| // count( $a ) |
| case "array_count": return array( ezcTemplateAstNode::TYPE_VALUE, array( "%array" ), |
| self::functionCall( "count", array( "%array" ) ) ); |
| |
| // array_contains( $a, $v ) ( QList::contains ):: |
| // in_array( $v, $a ) |
| case "array_contains": return array( ezcTemplateAstNode::TYPE_VALUE, array( "%array", "%value" ), |
| self::functionCall( "in_array", array( "%value", "%array" ) ) ); |
| |
| // array_is_empty( $a ) ( QList::isEmpty() ):: |
| // count( $a ) === 0 |
| case "array_is_empty": return array( ezcTemplateAstNode::TYPE_VALUE, array( "%array" ), |
| array( "ezcTemplateIdenticalOperatorAstNode", array( |
| self::functionCall( "count", array( "%array" ) ), |
| self::value( 0 ) ) ) ); |
| |
| // array_index_of( $a, $v ) ( QList::indexOf() ):: |
| // array_search( $v, $a ) |
| case "array_index_of": return array( ezcTemplateAstNode::TYPE_VALUE, array( "%array", "%value" ), |
| self::functionCall( "array_search", array( "%value", "%array" ) ) ); |
| |
| // array_index_exists( $a, $index ) ( QMap::find ):: |
| // array_key_exists( $index, $a ) |
| case "array_index_exists": return array( ezcTemplateAstNode::TYPE_VALUE, array( "%array", "%index" ), |
| self::functionCall( "array_key_exists", array( "%index", "%array" ) ) ); |
| |
| // array_left( $a, $len ):: |
| // array_slice( $a, 0, $len ) |
| case "array_left": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array", "%length" ), |
| self::functionCall( "array_slice", array( "%array", self::value( 0 ), "%length" ) ) ); |
| |
| // array_right( $a, $len ):: |
| // array_slice( $a, 0, -$len ) |
| case "array_right": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array", "%length" ), |
| self::functionCall( "array_slice", array( "%array", self::value( 0 ), |
| array( "ezcTemplateArithmeticNegationOperatorAstNode", array( "%length" ) ) ) ) ); |
| |
| // array_mid( $a, $index, $len ) ( QValueList::mid ):: |
| // array_slice( $a, $index, $len ) |
| case "array_mid": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array", "%index", "%length" ), |
| self::functionCall( "array_slice", array( "%array", "%index", "%length" ) ) ); |
| |
| // array_insert( $a, $index, $v1 [, $v2 ...] ) ( QList::insert() ):: |
| // array_slice( $a, 0, $index ) + array( $v1 [, $v2 ...] ) + array_slice( $a, $index + value count ) |
| case "array_insert": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array", "%index", "%..." ), |
| self::functionCall( "array_merge", array( |
| self::functionCall( "array_slice", array( "%array", self::value( 0 ), "%index" ) ), |
| self::functionCall( "array", array( "%..." ) ), |
| self::functionCall( "array_slice", array( "%array", "%index" ) ) |
| ) ) ); |
| |
| // array_append( $a, $v1 [, $v2 ...] ) ( QList::append() ):: |
| // Call user code. |
| case "array_append": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array", "%..." ), |
| self::functionCall( "ezcTemplateArray::array_append", array( "%array", "%..." ) ) ); |
| |
| // array_prepend( $a, $v1 [, $v2 ...] ) ( QList::prepend ):: |
| // array_unshift( $a, $v1 [, $v2 ...] ) |
| case "array_prepend": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array", "%..." ), |
| self::functionCall( "ezcTemplateArray::array_prepend", array( "%array", "%..." ) ) ); |
| |
| // array_merge( $a1, $a2 [, $a3 ..] ) ( QList::+ ):: |
| // array_merge( $a1, $a2 [, $a3 ...] ) |
| case "array_merge": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%first", "%..." ), |
| self::functionCall( "array_merge", array( "%first", "%..." ) ) ); |
| |
| // array_remove( $a, $index, $len = 1 ) ( QList::remove ):: |
| // array_slice( $a, 0, $index ) + array_slice( $a, $index + $len ) |
| case "array_remove": |
| $length = ( self::countParameters( $parameters ) == 2 ? self::value( 1 ) : "[%length]" ); |
| return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array", "%index", "[%length]" ), |
| self::functionCall( "array_merge", array( |
| self::functionCall( "array_slice", array( "%array", self::value( 0 ), "%index" ) ), |
| self::functionCall( "array_slice", array( "%array", |
| array( "ezcTemplateAdditionOperatorAstNode", array( "%index", $length ) ) |
| ) ) ) ) ); |
| |
| // array_remove_first( $a, $len = 1 ) ( QList::removeFirst() ):: |
| // array_slice( $a, 1 ) |
| case "array_remove_first": |
| $length = ( self::countParameters( $parameters ) == 1 ? self::value( 1 ) : "[%length]" ); |
| return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array", "[%length]" ), |
| self::functionCall( "array_slice", array( "%array", $length ) ) ); |
| |
| // array_remove_last( $a, $len = 1 ) ( QList::removeLast() ):: |
| // array_slice( $a, 0, -1 ) |
| case "array_remove_last": |
| $length = ( self::countParameters( $parameters ) == 1 ? self::value( 1 ) : "[%length]" ); |
| return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array", "[%length]" ), |
| self::functionCall( "array_slice", array( "%array", self::value( 0 ), array( "ezcTemplateArithmeticNegationOperatorAstNode", array( $length ) ) ) ) ); |
| |
| // array_first( $a ) ( QList::first ):: |
| // count( $a ) > 0 ? $a[0] : false |
| // TODO, ? : |
| |
| // array_last( $a ) ( QList::last ):: |
| // count( $a ) > 0 ? $a[count( $a ) - 1] : false |
| // TODO, ? : |
| |
| // array_replace( $a, $index, $len = 1, $v1 [, $v2 ...] ) ( QList::replace ):: |
| // array_slice( $a, 0, $index ) + array( $v1 [, $v2 ...] ) + array_slice( $a, $index + $len ) |
| case "array_replace": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array", "%index", "%length", "%..." ), |
| self::functionCall( "array_merge", array( |
| self::functionCall( "array_slice", array( "%array", self::value( 0 ), "%index" ) ), |
| self::functionCall( "array", array( "%..." ) ), |
| self::functionCall( "array_slice", array( "%array", array( "ezcTemplateAdditionOperatorAstNode", array( "%index", "%length" ) ) ) ) |
| ) ) ); |
| |
| // array_swap( $a, $index1, $index2 ) ( QList::swap ) ?:: |
| case "array_swap": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array", "%index1", "%index2"), |
| self::functionCall( "ezcTemplateArray::array_swap", array( "%array", "%index1", "%index2") ) ); |
| |
| // array_at( $a, $index ) ( QList::at ):: |
| // $a[$index] |
| // TODO, $a cannot be an array definition. |
| |
| // array_reverse( $a ):: |
| // array_reverse( $a ) |
| case "array_reverse": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array" ), |
| self::functionCall( "array_reverse", array( "%array" ) ) ); |
| |
| // array_diff( $a1, $a2 [, $a3 ...] ):: |
| // array_diff( $a1, $a2 [, $a3 ...] ) |
| case "array_diff": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array1", "%array2", "[%...]" ), |
| self::functionCall( "array_diff", array( "%array1", "%array2", "[%...]") ) ); |
| |
| // array_intersect( $a1, $a2 [, $a3 ...] ):: |
| // array_intersect( $a1, $a2 [, $a3 ...] ) |
| case "array_intersect": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array1", "%array2", "[%...]" ), |
| self::functionCall( "array_intersect", array( "%array1", "%array2", "[%...]") ) ); |
| |
| // array_pad( [$a = array(),] $len, $fill ):: |
| // array_pad( $a, $len, $fill ) |
| case "array_pad": |
| |
| if ( self::countParameters( $parameters ) == 2 ) |
| { |
| return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%length", "%pad" ), |
| self::functionCall( "array_pad", array( self::functionCall( "array", array() ), "%length", "%pad" ) ) ); |
| } |
| else |
| { |
| return array( ezcTemplateAstNode::TYPE_ARRAY, array( "[%array]", "%length", "%pad" ), |
| self::functionCall( "array_pad", array( "[%array]", "%length", "%pad" ) ) ); |
| } |
| |
| // array_unique( $a ):: |
| // array_unique( $a ) |
| case "array_unique": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%array" ), |
| self::functionCall( "array_unique", array( "%array" ) ) ); |
| |
| // array_find( $a, $v ):: |
| // array_search( $v, $a ) |
| case "array_find": return array( array( "%array", "%value" ), |
| self::functionCall( "array_search", array( "%value", "%array" ) ) ); |
| |
| // array_find_replace( $a, $v, $vNew ):: |
| // $key = array_search( $v, $a ); if ( $key ) $a[$key] = $vNew; |
| case "array_find_replace": return array( array( "%array", "%find", "%replace" ), |
| self::functionCall( "ezcTemplateArray::array_find_replace", array( "%array", "%find", "%replace" ) ) ); |
| |
| // array_range( $low, $high [, $step] ):: |
| // array_range( $low, $high [, $step] ) |
| case "array_fill_range": return array( ezcTemplateAstNode::TYPE_ARRAY, array( "%low", "%high", "[%step]" ), |
| self::functionCall( "range", array( "%low", "%high", "[%step]" ) ) ); |
| |
| // array_sum( $a ):: |
| // array_sum( $a ) |
| case "array_sum": return array( ezcTemplateAstNode::TYPE_VALUE, array( "%array" ), |
| self::functionCall( "array_sum", array( "%array" ) ) ); |
| |
| // array_extract_by_properties( $a, $pList ):: |
| // TODO Needs testing. |
| case "array_extract_by_properties": return array( array( "%array", "%properties" ), |
| self::functionCall( "ezcTemplateArray::array_extract_by_properties", array( "%array", "%properties" ) ) ); |
| |
| // array_extract_by_keys( $a, $kList ):: |
| // |
| // array_sum( array_extract_by_keys( $order.items, array( 'price' ) ) ) |
| // |
| // becomes |
| // |
| // foreach ( $order->items as $item ) |
| // { |
| // $list[] = $item['price']; |
| // } |
| // array_sum( $list ) |
| // unset( $list |
| // TODO |
| |
| |
| // array_fill( $v, $len ) ( QVector::fill ):: |
| // array_fill( 0, $len, $v ) |
| // Skipped, can be done with array_pad. |
| |
| // array_repeat( $asrc, $len ) ( QVector::fill ):: |
| // $aout = array(); for ( $i = 0; $i < $len; ++$i ) { $aout += $a; } |
| case "array_repeat": return array( array( "%array", "%length" ), |
| self::functionCall( "ezcTemplateArray::array_repeat", array( "%array", "%length" ) ) ); |
| |
| |
| case "array_sort": return array( array( "%array" ), |
| self::functionCall( "ezcTemplateArray::array_sort", array( "%array" ) ) ); |
| |
| case "array_sort_reverse": return array( array( "%array" ), |
| self::functionCall( "ezcTemplateArray::array_sort_reverse", array( "%array" ) ) ); |
| |
| case "hash_sort": return array( array( "%array" ), |
| self::functionCall( "ezcTemplateArray::hash_sort", array( "%array" ) ) ); |
| |
| case "hash_sort_reverse": return array( array( "%array" ), |
| self::functionCall( "ezcTemplateArray::hash_sort_reverse", array( "%array" ) ) ); |
| |
| case "hash_sort_keys": return array( array( "%array" ), |
| self::functionCall( "ezcTemplateArray::hash_sort_keys", array( "%array" ) ) ); |
| |
| case "hash_sort_keys_reverse": return array( array( "%array" ), |
| self::functionCall( "ezcTemplateArray::hash_sort_keys_reverse", array( "%array" ) ) ); |
| |
| // hash_diff( $a1, $a2 [, $a3 ...] ):: |
| // array_diff_assoc( $a1, $a2 [, $a3 ...] ) |
| case "hash_diff": return array( array( "%array1", "%array2", "[%...]" ), |
| self::functionCall( "array_diff_assoc", array( "%array1", "%array2", "[%...]") ) ); |
| |
| // hash_diff_key( $a1, $a2 [, $a3 ...] ):: |
| // array_diff_key( $a1, $a2 [, $a3 ...] ) |
| case "hash_diff_key": return array( array( "%array1", "%array2", "[%...]" ), |
| self::functionCall( "array_diff_key", array( "%array1", "%array2", "[%...]") ) ); |
| |
| // hash_intersect( $a1, $a2 [, $a3 ...] ):: |
| // array_intersect_assoc( $a1, $a2 [, $a3 ...] ) |
| case "hash_intersect": return array( array( "%array1", "%array2", "[%...]" ), |
| self::functionCall( "array_intersect_assoc", array( "%array1", "%array2", "[%...]") ) ); |
| |
| // hash_intersect_key( $a1, $a2 [, $a3 ...] ):: |
| // array_intersect( $a1, $a2 [, $a3 ...] ) |
| case "hash_intersect_key": return array( array( "%array1", "%array2", "[%...]" ), |
| self::functionCall( "array_intersect_key", array( "%array1", "%array2", "[%...]") ) ); |
| |
| // hash_keys( $a ) ( QMap::keys ):: |
| // array_keys( $a ) |
| case "hash_keys": return array( array( "%array" ), |
| self::functionCall( "array_keys", array( "%array") ) ); |
| |
| // hash_values( $a ):: |
| // array_values( $a ) |
| case "hash_values": return array( array( "%array" ), |
| self::functionCall( "array_values", array( "%array") ) ); |
| |
| // hash_flip( $a ):: |
| // array_flip( $a ) |
| case "hash_flip": return array( array( "%array" ), |
| self::functionCall( "array_flip", array( "%array") ) ); |
| } |
| |
| return null; |
| } |
| } |
| ?> |
