X-Git-Url: https://git.mxchange.org/?p=core.git;a=blobdiff_plain;f=framework%2Fmain%2Finterfaces%2Fstacker%2Fclass_Stackable.php;h=4881c6f6d9565641d2ba15be6e2f9d317ecae34f;hp=8cdb6e7dfaf1b46457c236c711cf06cfc7fef487;hb=refs%2Fheads%2Fmaster;hpb=cad1ab5ecb2935a6ebf678555860c3bd96b525b0 diff --git a/framework/main/interfaces/stacker/class_Stackable.php b/framework/main/interfaces/stacker/class_Stackable.php index 8cdb6e7d..4881c6f6 100644 --- a/framework/main/interfaces/stacker/class_Stackable.php +++ b/framework/main/interfaces/stacker/class_Stackable.php @@ -1,6 +1,6 @@ * @version 0.0.0 -<<<<<<< HEAD:framework/main/interfaces/stacker/class_Stackable.php - * @copyright Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2017 Core Developer Team -======= - * @copyright Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2016 Core Developer Team ->>>>>>> Some updates::inc/main/interfaces/stacker/class_Stackable.php + * @copyright Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2023 Core Developer Team * @license GNU GPL 3.0 or any newer version * @link http://www.shipsimu.org * @@ -38,29 +34,29 @@ interface Stackable extends FrameworkInterface { * @param $stackerName Name of the stacker * @param $value Value to push on it * @return void - * @throws StackerFullException If the stacker is full + * @throws BadMethodCallException If the stacker is full */ - function pushNamed ($stackerName, $value); + function pushNamed (string $stackerName, $value); /** * 'Pops' a value from a named stacker and returns it's value * * @param $stackerName Name of the stacker * @return $value Value of the current stack entry - * @throws NoStackerException If the named stacker was not found - * @throws EmptyStackerException If the named stacker is empty + * @throws BadMethodCallException If the named stacker was not found + * @throws BadMethodCallException If the named stacker is empty */ - function popNamed ($stackerName); + function popNamed (string $stackerName); /** * Get value from named stacker but don't "pop" it * * @param $stackerName Name of the stacker * @return $value Value of last added value - * @throws NoStackerException If the named stacker was not found - * @throws EmptyStackerException If the named stacker is empty + * @throws BadMethodCallException If the named stacker was not found + * @throws BadMethodCallException If the named stacker is empty */ - function getNamed ($stackerName); + function getNamed (string $stackerName); /** * Checks whether the given stack is initialized (set in array $stackers) @@ -68,15 +64,41 @@ interface Stackable extends FrameworkInterface { * @param $stackerName Name of the stack * @return $isInitialized Whether the stack is initialized */ - function isStackInitialized ($stackerName); + function isStackInitialized (string $stackerName); /** * Checks whether the given stack is empty * * @param $stackerName Name of the stack * @return $isEmpty Whether the stack is empty - * @throws NoStackerException If given stack is missing + * @throws BadMethodCallException If given stack is missing */ - function isStackEmpty ($stackerName); + function isStackEmpty (string $stackerName); + + /** + * Initializes given stacker + * + * @param $stackerName Name of the stack + * @param $forceReInit Force re-initialization + * @return void + * @throws UnsupportedOperationException This method is not (and maybe never will be) supported + */ + function initStack (string $stackerName, bool $forceReInit = false); + + /** + * Initializes all stacks + * + * @return void + * @throws UnsupportedOperationException This method is not (and maybe never will be) supported + */ + function initStacks (array $stacks, bool $forceReInit = false); + + /** + * Getter for size of given stack (array count) + * + * @param $stackerName Name of the stack + * @return $count Size of stack (array count) + */ + function getStackCount (string $stackerName); }