Skip to content

BFCollections is a set of collections classes for PHP 5.x.

Notifications You must be signed in to change notification settings

bubblefoundry/BFCollections

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 

Repository files navigation

BFCollections is a collection (ha! get it?) of collections classes for PHP 5.3+. They should make your code cleaner, more concise, and more correct.

They include:

  • BFArray: A better array. It can be used just like a native array but it also has methods for common array operations such as map, filter, and reduceLeft.
  • Option: Indicates an optional return result, via the form of an instance of the Some class or the global $None. Inspired by Scala's Option (naturally) and Haskell's Maybe. There are basic methods to operate on the values.
  • Box: Again indicates an optional return result, though the lack of a value can also be indicated and even chained. Inspired by the Lift framework's Box.
  • PartialFunction: Again Scala inspired, partial functions are functions that do not have output for every possible input and that are easily combined or composed. The Wikipedia page on partial functions has more on the mathematical theory.

Partial Function Examples

PartialFunctions do a very simple form of pattern matching by either testing input, either for strict equality (===) against the condition or as a true result when processed by the callable condition.

$f = pf(
  pfCase(function ($i) { return is_integer($i); }, function ($i) { return "$i is an integer"; }),
  pfCase("test", function ($str) { return "$str == test"; })
);
var_dump($f->isDefinedAt(1)); // -> bool(true)
print($f("test")); // -> test == test

$f2 = $f->orElse(pf(
  pfCase($always, function () {
    return "Our wildcard catch got the following arguments: " . print_r(func_get_args(), true);
  })
));
print($f2(1, 2, 3)); // -> Our wildcard catch got the following arguments: Array ( [0] => 1 [1] => 2 [2] => 3 )

$f3 = $f2->andThen(function ($result) { return "<p><strong>$result</strong></p>"; });
print($f3(1412)); // -> <p><strong>1412 is an integer</strong></p>

About

BFCollections is a set of collections classes for PHP 5.x.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 100.0%