*
* @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 - 2015 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 FrameworkDirectory {
/**
* 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->getDirectoryIteratorInstance() instanceof DirectoryIterator) {
// Try to close a directory
$this->closeDirectory();
} // END - if
}
}
- // Get an iterator for the directory
- $directoryInstance = new DirectoryIterator($pathName);
-
// Create new instance
$pointerInstance = new FrameworkDirectoryPointer();
+ // Get an iterator for the directory
+ $iteratorInstance = new DirectoryIterator($pathName);
+
+ // ... and rewind back
+ $iteratorInstance->rewind();
+
// Set directory pointer and path name
- $pointerInstance->setDirectoryInstance($directoryInstance);
+ $pointerInstance->setDirectoryIteratorInstance($iteratorInstance);
$pointerInstance->setPathName($pathName);
// Return the instance
+ //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: Opened pathName=' . $pathName . ' - EXIT!');
return $pointerInstance;
}
/**
* Read raw lines of data from a directory pointer and return the data
*
- * @return $current Current entry from encapsulated iterator
+ * @return $currentEntry Current entry from encapsulated iterator
*/
public function readRawDirectory () {
- // Can the next entry be read?
- assert($this->getDirectoryInstance()->valid());
-
- // Default is FALSE
- $current = FALSE;
+ //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . '] - CALLED!');
- // Is it a dot directory?
- if (!$this->getDirectoryInstance()->isDot()) {
- // Read data from the directory pointer and return it
- $current = $this->getDirectoryInstance()->current();
- } // END - if
+ // Can the next entry be read?
+ assert($this->getDirectoryIteratorInstance()->valid());
- // Advance to next entry
- $this->getDirectoryInstance()->next();
+ // Read data from the directory pointer and return it
+ $currentEntry = $this->getDirectoryIteratorInstance()->current();
// Return found entry
- return $current;
+ //* 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->getDirectoryIteratorInstance()->valid()) {
+ // No more left to read
+ //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: EOD reached.');
+ return NULL;
+ }
+
+ // Init raw line
+ $rawLine = NULL;
// Read a raw line...
- $rawLine = $this->readRawDirectory();
- //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: rawLine[' . gettype($rawLine) . ']=' . $rawLine);
+ $currentEntry = $this->readRawDirectory();
+ //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: currentEntry[]=' . gettype($currentEntry));
// Shall we exclude directories?
- if ((!is_null($rawLine)) && ($rawLine !== FALSE) && (!in_array($rawLine, $except))) {
- // Return read data
- //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: rawLine[' . gettype($rawLine) . ']=' . $rawLine);
- return $rawLine;
- } elseif ((!is_null($rawLine)) && ($rawLine !== FALSE)) {
- // Exclude this part
- //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: rawline[' . gettype($rawLine) . ']=' . $rawLine . ' - Recursive call!');
- return $this->readDirectoryExcept($except);
- }
+ if (is_object($currentEntry)) {
+ // Get file name
+ $rawLine = $currentEntry->getFilename();
+ //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: rawLine[' . gettype($rawLine) . ']=' . $rawLine . ',isDot=' . intval($this->getDirectoryIteratorInstance()->isDot()));
+
+ // Is it a dot-directory or excluded?
+ if (($this->getDirectoryIteratorInstance()->isDot()) || (in_array($rawLine, $except))) {
+ // To next entry
+ $this->getDirectoryIteratorInstance()->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->getDirectoryIteratorInstance()->next();
- // End pointer reached
- //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: Returning NULL!');
- return NULL;
+ // 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->unsetDirectoryIteratorInstance();
$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
* @return void
*/
- protected final function setDirectoryInstance (DirectoryIterator $directoryInstance = NULL) {
- // Set instance (or NULL)
- $this->directoryInstance = $directoryInstance;
+ protected final function setDirectoryIteratorInstance (DirectoryIterator $iteratorInstance) {
+ // Set instance
+ $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 getDirectoryIteratorInstance () {
+ return $this->iteratorInstance;
+ }
+
+ /**
+ * Remove directory iterator instance (effectively closing it) by setting
+ * it to NULL. This will trigger a call on the destructor which will then
+ * "close" the iterator.
+ *
+ * @param $iteratorInstance An instanceof a DirectoryIterator class
+ * @return void
*/
- public final function getDirectoryInstance () {
- return $this->directoryInstance;
+ protected final function unsetDirectoryIteratorInstance () {
+ // "Unset" the instance
+ $this->iteratorInstance = NULL;
}
/**
* @param $pathName The new path name
* @return void
*/
- public final function setPathName ($pathName) {
+ protected final function setPathName ($pathName) {
$pathName = (string) $pathName;
$this->pathName = $pathName;
}