* 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
- $directoryInstance->rewind();
+ $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__ . '] - CALLED!');
// Can the next entry be read?
- assert($this->getDirectoryInstance()->valid());
+ assert($this->getIteratorInstance()->valid());
// Default is FALSE
$currentEntry = FALSE;
// Read data from the directory pointer and return it
- $currentEntry = $this->getDirectoryInstance()->current();
+ $currentEntry = $this->getIteratorInstance()->current();
// Return found entry
//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: currentEntry[]=' . gettype($currentEntry) . ' - EXIT!');
// 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();
- } elseif (!$this->getDirectoryInstance()->valid()) {
+ } elseif (!$this->getIteratorInstance()->valid()) {
// No more left to read
return NULL;
}
// Is it not excluded?
if (in_array($rawLine, $except)) {
// To next entry
- $this->getDirectoryInstance()->next();
+ $this->getIteratorInstance()->next();
// Exclude this part
$rawLine = $this->readDirectoryExcept($except);
} // END - if
// To next entry
- $this->getDirectoryInstance()->next();
+ $this->getIteratorInstance()->next();
// Return read line
//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('DIRECTORY[' . __METHOD__ . ':' . __LINE__ . ']: rawLine[' . gettype($rawLine) . ']=' . $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;
}