*
* @author Roland Haeder <webmaster@shipsimu.org>
* @version 0.0.0
- * @copyright Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2013 Core Developer Team
+ * @copyright Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2014 Core Developer Team
* @license GNU GPL 3.0 or any newer version
* @link http://www.shipsimu.org
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
-class FrameworkDirectoryPointer extends BaseFrameworkSystem {
+class FrameworkDirectoryPointer extends BaseFrameworkSystem implements Directory {
/**
* The current path we are working in
*/
/**
* The directory iterator instance
*/
- private $directoryInstance = NULL;
+ private $iteratorInstance = NULL;
/**
* Protected constructor
*/
public function __destruct() {
// Is there a resource pointer? Then we have to close the directory here!
- if ($this->getDirectoryInstance() instanceof DirectoryIterator) {
+ if ($this->getIteratorInstance() instanceof DirectoryIterator) {
// Try to close a directory
$this->closeDirectory();
} // END - if
$pointerInstance = new FrameworkDirectoryPointer();
// Get an iterator for the directory
- $directoryInstance = new DirectoryIterator($pathName);
+ $iteratorInstance = new DirectoryIterator($pathName);
+
+ // ... and rewind back
+ $iteratorInstance->rewind();
// Set directory pointer and path name
- $pointerInstance->setDirectoryInstance($directoryInstance);
+ $pointerInstance->setIteratorInstance($iteratorInstance);
$pointerInstance->setPathName($pathName);
// Return the instance
+ //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: Opened pathName=' . $pathName . ' - EXIT!');
return $pointerInstance;
}
* @return $currentEntry Current entry from encapsulated iterator
*/
public function readRawDirectory () {
+ //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . '] - CALLED!');
+
// Can the next entry be read?
- assert($this->getDirectoryInstance()->valid());
+ assert($this->getIteratorInstance()->valid());
// Default is FALSE
$currentEntry = FALSE;
- // Is it a dot directory?
- if (!$this->getDirectoryInstance()->isDot()) {
- // Read data from the directory pointer and return it
- $currentEntry = $this->getDirectoryInstance()->current();
- } // END - if
-
- // Advance to next entry
- $this->getDirectoryInstance()->next();
+ // Read data from the directory pointer and return it
+ $currentEntry = $this->getIteratorInstance()->current();
// Return found entry
+ //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: currentEntry[]=' . gettype($currentEntry) . ' - EXIT!');
return $currentEntry;
}
// No exception given, so read all files and directories, but not recursive
self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: No exceptions given, please use readRawDirectory() instead!');
return $this->readRawDirectory();
- } // END - if
+ } elseif (!$this->getIteratorInstance()->valid()) {
+ // No more left to read
+ return NULL;
+ }
// Init raw line
$rawLine = NULL;
// Is it not excluded?
if (in_array($rawLine, $except)) {
+ // To next entry
+ $this->getIteratorInstance()->next();
+
// Exclude this part
$rawLine = $this->readDirectoryExcept($except);
//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: rawline[' . gettype($rawLine) . ']=' . $rawLine . ' - Recursive call!');
} // END - if
} // END - if
+ // To next entry
+ $this->getIteratorInstance()->next();
+
// Return read line
//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: rawLine[' . gettype($rawLine) . ']=' . $rawLine);
return $rawLine;
*/
public function closeDirectory () {
// Close the directory by unsetting it
- $this->setDirectoryInstance(NULL);
+ $this->setIteratorInstance(NULL);
$this->setPathName('');
}
/**
* Setter for the directory pointer
*
- * @param $directoryInstance An instanceof a DirectoryIterator class or NULL to unset ("close") it.
+ * @param $iteratorInstance An instanceof a DirectoryIterator class or NULL to unset ("close") it.
* @return void
*/
- protected final function setDirectoryInstance (DirectoryIterator $directoryInstance = NULL) {
+ protected final function setIteratorInstance (DirectoryIterator $iteratorInstance = NULL) {
// Set instance (or NULL)
- $this->directoryInstance = $directoryInstance;
+ $this->iteratorInstance = $iteratorInstance;
}
/**
* Getter for the directory pointer
*
- * @return $directoryInstance The directory pointer which shall be a valid directory resource
+ * @return $iteratorInstance The directory pointer which shall be a valid directory resource
*/
- public final function getDirectoryInstance () {
- return $this->directoryInstance;
+ public final function getIteratorInstance () {
+ return $this->iteratorInstance;
}
/**
* @param $pathName The new path name
* @return void
*/
- public final function setPathName ($pathName) {
+ protected final function setPathName ($pathName) {
$pathName = (string) $pathName;
$this->pathName = $pathName;
}