FuncUtility.php文件-（操作可编辑数据集中的值）

Posted 2021-02-26

This class can be used to Manipulate values in iterable data sets.

It can iterate over a set of elements contained in a collection managed by an object that implements the Iterable interface.

The class executes several types of operations to manipulate the collection elements by invoking given callback functions that determine what to do with the elements.

Currently it can filter a subset of the elements, call a function to manipulate each of the elements, map the elements to a new set of values, reduce the elements to a single value.

<?php
/**
 * Allows to use FP-like features for arrays, strings, SPL iterators and even results
 * returned from callbacks
 *
 * This class adds a lot of syntax sugar to your recordset processing routines or other
 * similar tasks when you don't want to write a loop construct. You will never see the
 * calls of FuncUtility methods in the Frontier's core. It uses call_user_func(),
 * which is slow. But I hope, it's performance will be improved someday though.
 *
 * @author Stanis Shramko <[email protected]>
 */
class FuncUtility
{
 
  /**
   * Filters all elements of $set using the $callback
   *
   * @return array
   * @throws InvalidArgumentException
   */
  public static function filter($callback, $set)
  {
    if (!is_callable($callback))
    {
      throw new InvalidArgumentException(
        'The first argument is not callable');
    }
    $values = array();
    if (is_callable($set))
    {
      while ($value = call_user_func($set))
      {
        if (call_user_func($callback, $value))
        {
          $values[] = $value;
        }
      }
    }
    else
    {
      foreach (($set = self::prepareIterable($set)) as $value)
      {
        if (call_user_func($callback, $value))
          $values[] = $value;
      }
    }
    return $values;
  }
 
  /**
   * Applies the $callback to all elements of $set
   *
   * @return void
   * @throws InvalidArgumentException
   */
  public static function each($callback, $set)
  {
    if (!is_callable($callback))
    {
      throw new InvalidArgumentException(
        'The first argument is not callable');
    }
    if (is_callable($set))
    {
      while ($value = call_user_func($set))
      {
        call_user_func($callback, $value);
      }
    }
    else
    {
      foreach (($set = self::prepareIterable($set)) as $value)
      {
        call_user_func($callback, $value);
      }
    }
  }
 
  /**
   * Applies the $callback to all elements of $set
   *
   * @return array
   * @throws InvalidArgumentException
   */
  public static function map($callback, $set)
  {
    if (!is_callable($callback))
    {
      throw new InvalidArgumentException(
        'The first argument is not callable');
    }
    $values = array();
    if (is_callable($set))
    {
      while ($value = call_user_func($set))
      {
        $values[] = call_user_func($callback, $value);
      }
    }
    else
    {
      foreach (($set = self::prepareIterable($set)) as $value)
      {
        $values[] = call_user_func($callback, $value);
      }
    }
    return $values;
  }
 
  /**
   * Reduces the $set using $result
   *
   * @return array
   * @throws InvalidArgumentException
   */
  public static function reduce($callback, $set)
  {
    if (!is_callable($callback))
    {
      throw new InvalidArgumentException(
        'The first argument is not callable');
    }
    if (is_callable($set))
    {
      $result = call_user_func($set);
      while ($value = call_user_func($set))
      {
        $result = call_user_func($callback, $result, $value);
      }
    }
    else
    {
      $first = true;
      foreach (($set = self::prepareIterable($set)) as $value)
      {
        if (!$first)
        {
          $result = call_user_func($callback, $result,
            $value);
        }
        else
        {
          $result = $value;
          $first = false;
        }
      }
    }
    return $result;
  }
 
  /**
   * Prepares "something iterable"
   *
   * @param mixed $set
   * @return mixed array or Iterator
   */
  protected static function prepareIterable($set)
  {
    if (is_array($set) || $set instanceof Iterator)
    {
      return $set;
    }
    if (is_string($set))
    {
      return str_split($set);
    }
    throw new InvalidArgumentException('The second argument is not iterable');
  }
 
}