diff options
author | Luke Shumaker <lukeshu@sbcglobal.net> | 2016-05-01 15:30:02 -0400 |
---|---|---|
committer | Luke Shumaker <lukeshu@sbcglobal.net> | 2016-05-01 15:30:02 -0400 |
commit | 1de335ad3f395ca6861085393ba366a9e3fb4a0d (patch) | |
tree | f1fdd326034e05177596851be6a7127615d81498 /includes/libs/DeferredStringifier.php | |
parent | 9c75fa8ff6d4d38ef552c00fef5969fb154765e8 (diff) | |
parent | f6d65e533c62f6deb21342d4901ece24497b433e (diff) |
Merge commit 'f6d65'
# Conflicts:
# skins/ArchLinux/ArchLinux.php
Diffstat (limited to 'includes/libs/DeferredStringifier.php')
-rw-r--r-- | includes/libs/DeferredStringifier.php | 57 |
1 files changed, 57 insertions, 0 deletions
diff --git a/includes/libs/DeferredStringifier.php b/includes/libs/DeferredStringifier.php new file mode 100644 index 00000000..a6fd11a4 --- /dev/null +++ b/includes/libs/DeferredStringifier.php @@ -0,0 +1,57 @@ +<?php +/** + * Class that defers a slow string generation until the string is actually needed. + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + * http://www.gnu.org/copyleft/gpl.html + * + * @file + */ + +/** + * @since 1.25 + */ +class DeferredStringifier { + /** @var callable Callback used for result string generation */ + private $callback; + + /** @var array */ + private $params; + + /** @var string */ + private $result; + + /** + * @param callable $callback Callback that gets called by __toString + * @param mixed $param,... Parameters to the callback + */ + public function __construct( $callback /*...*/ ) { + $this->params = func_get_args(); + array_shift( $this->params ); + $this->callback = $callback; + } + + /** + * Get the string generated from the callback + * + * @return string + */ + public function __toString() { + if ( $this->result === null ) { + $this->result = call_user_func_array( $this->callback, $this->params ); + } + return $this->result; + } +} |