rfc:functional-elements

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
Next revisionBoth sides next revision
rfc:functional-elements [2008/03/06 02:00] – Initial creation. Introduction, current use cases lstrojnyrfc:functional-elements [2008/03/16 14:10] – Typo lstrojny
Line 1: Line 1:
-====== Functional elements for object lists ======+This RFC is still in progress 
 +====== Functional elements to work with aggregations ======
 ==== Abstract ==== ==== Abstract ====
-A common pattern in PHP is iterating through a list of objects and executing certain methods of the function. This is especially common when it comes to 1:n-relations (e.g. one object, n adapters). This proposal is meant to abstract those iterations in convenient functional constructs.+A common pattern in PHP is iterating through a list of objects and executing certain methods of the objects. This is especially common when it comes to 1:n-relations (e.g. one object, n adapters). This proposal is meant to abstract those iterations in convenient functional constructs by adding method call iterators and iterator functions.
  
-==== Current examples ==== +==== Current usage patterns ==== 
-=== UC-1 ===+=== UC-1: Iterating over an aggregation of objects ===
 <code php> <code php>
 foreach ($list as $element) { foreach ($list as $element) {
Line 11: Line 12:
 </code> </code>
  
-=== UC-2 ===+=== UC-2: Iterating over an aggregation of objects and keeping the results ===
 <code php> <code php>
 $result = array(); $result = array();
Line 19: Line 20:
 </code> </code>
  
-=== UC-3 ===+=== UC-3: Iterating over an aggregation of objects and conditionally executing a method ===
 <code php> <code php>
 foreach ($list as $element) { foreach ($list as $element) {
Line 28: Line 29:
 </code> </code>
  
-=== UC-4 ===+=== UC-4: Iterating over an aggregation of objects and conditionally executing a method while keeping the results ===
 <code php> <code php>
 $result = array(); $result = array();
Line 36: Line 37:
     }     }
 } }
 +</code>
 +
 +==== Extracted functions ====
 +=== spl_iterator_element_call() ===
 +<code php>
 +array|bool spl_iterator_element_call(
 +    array|Iterator $iterator,
 +    string|array $methods,
 +    array $params = array(),
 +    bool $collect = true
 +)
 +</code>
 +
 +Iterating over a list of objects, call method "testMethod" and get the list of results:
 +<code php>
 +$result = spl_iterator_element_call($list, 'testMethod');
 +</code>
 +
 +Iterating over a list of objects, call methods "testMethod" (with param "test") and "otherTestMethod" (with param "other") and get the list of results:
 +<code php>
 +$result = spl_iterator_element_call($list, array('testMethod', 'otherTestMethod'), array('test', 'other'));
 +</code>
 +
 +Iterating over a list of objects, call method 'testMethod' (with param "test1" and "test2") and "otherTestMethod" (with param "other1" and "other2") and get the list of results:
 +<code php>
 +$result = spl_iterator_element_call($list, array('testMethod', 'otherTestMethod'), array(array('test1', 'test2'), array('other1', 'other2')));
 +</code>
 +
 +=== spl_iterator_element_call_conditional() ===
 +<code php>
 +array|mixed spl_iterator_element_call_conditional(
 +    array|Iterator $iterator,
 +    string|array $methods,
 +    string|array $conditions,
 +    array $params = array(),
 +    array $condition_params = array(),
 +    bool $collect = true,
 +    bool $finite = true
 +)
 </code> </code>
rfc/functional-elements.txt · Last modified: 2017/09/22 13:28 by 127.0.0.1

Page Tools