Class: Io

Source Location: /phpDocumentor/Io.inc

Class Io

Class Overview

Class to handle file and user io opperations

Located in /phpDocumentor/Io.inc [line 50]

Author(s):

Joshua Eichorn <[email protected]>
Gregory Beaver <[email protected]>

Information Tags:

Version:

$Id: Io.inc,v 1.12 2006/05/23 13:09:26 cellog Exp $

Properties

Methods

[ Top ]

Property Summary

false\|array	$ignore	Format: array(array(regexp-ready string to search for whole path,
mixed	$phpDocOptions	Holds all the options that are avaible to the cmd line interface

[ Top ]

Method Summary

Io	Io()	creates an array $this->phpDocOptions and sets program options in it.
bool	checkIgnore()	Tell whether to ignore a file or a directory allows * and ? wildcards
array	dirList()
string	displayHelpMsg()	create the help message for display on the command-line
mixed	getAllFiles()	Take a filename with wildcards and return all files that match the
void	getBase()	Retrieve common directory (case-insensitive in windows)
void	getDirTree()
array	getReadmeInstallChangelog()
string	getRegExpableSearchString()	Converts $s into a string that can be used with preg_match
array	getTutorials()	Retrieve tutorial subdirectories and their contents from the list of
boolean	isIncludeable()	calls http://www.php.net/file_exists for each value in include_path,
array	parseArgv()	Parses $_SERVER['argv'] and creates a setup array
void	readPhpFile()	Reads a file and returns it as a string Does basic error checking
string\|array	removeNonMatches()	Removes files from the $dir array that do not match the search string in
void	_setupIgnore()	Construct the $ignore array

[ Top ]

Properties

false|array $ignore = false [line 63]

Format: array(array(regexp-ready string to search for whole path,

regexp-ready string to search for basename of ignore strings),...)

[ Top ]

mixed $phpDocOptions [line 57]

Holds all the options that are avaible to the cmd line interface

and to the different web interfaces

[ Top ]

Methods

Constructor Io [line 74]

Io Io(
)

creates an array $this->phpDocOptions and sets program options in it.

Array is in the format of:

 [filename][tag][] = "f";
 [filename][tag][] = "-file";
 [filename][desc] "name of file to parse"

[ Top ]

checkIgnore [line 644]

bool checkIgnore(
string
$file, string
$path, array
$ignore, [
$ignore_no_ext = true] 
)

Tell whether to ignore a file or a directory allows * and ? wildcards

Parameters:

string	$file:	just the file name of the file or directory, in the case of directories this is the last dir
string	$path:	the full path
array	$ignore:
	$ignore_no_ext:

API Tags:

Return:

true if $path should be ignored, false if it should not

Information Tags:

Author:

Greg Beaver <[email protected]>

[ Top ]

dirList [line 326]

array dirList(
string
$directory, [off|on
$hidden = "off"] 
)

Parameters:

string	$directory:	full path to the directory you want the list of
off\|on	$hidden:	whether to list files that begin with . like .bash_history

API Tags:

Return:

list of files in a directory

[ Top ]

displayHelpMsg [line 181]

string displayHelpMsg(
)

create the help message for display on the command-line

API Tags:

Return:

a string containing a help message

[ Top ]

getAllFiles [line 807]

mixed getAllFiles(
string
$file 
)

Take a filename with wildcards and return all files that match the

wildcards

Parameters:

string

$file:

a full path from the -f command-line parameter, with potential * and ? wildcards.

API Tags:

Return:

if $file contains wildcards, returns an array of matching files, otherwise returns false

Information Tags:

Author:

Greg Beaver <[email protected]>

[ Top ]

getBase [line 388]

void getBase(
array
$filelist 
)

Retrieve common directory (case-insensitive in windows)

takes the list of files, and returns the subdirectory they share in common, so in this list:

array(
"/dir1/dir2/subdir/dir3/filename.ext",
"/dir1/dir2/subdir/dir4/filename.ext",
"/dir1/dir2/mydir/dir5/filename.ext");

getBase will return "/dir1/dir2"

Parameters:

array

$filelist:

array of strings

[ Top ]

getDirTree [line 498]

void getDirTree(

$dir, 
$base_dir, [
$ignore = array()], [
$hidden = "off"] 
)

Parameters:

	$dir:
	$base_dir:
	$ignore:
	$hidden:

[ Top ]

getReadmeInstallChangelog [line 481]

array getReadmeInstallChangelog(
string
$base, array
$filelist 
)

Parameters:

string	$base:	base directory from getBase()
array	$filelist:	file list from dirList()

API Tags:

Return:

array(filelist - README/INSTALL/CHANGELOG, README/INSTALL/CHANGELOG)

[ Top ]

getRegExpableSearchString [line 753]

string getRegExpableSearchString(
string
$s 
)

Converts $s into a string that can be used with preg_match

Parameters:

string

$s:

string with wildcards ? and *

API Tags:

Return:

converts * to .*, ? to ., etc.

Information Tags:

Author:

Greg Beaver <[email protected]>

[ Top ]

getTutorials [line 437]

array getTutorials(
array
$filelist 
)

Retrieve tutorial subdirectories and their contents from the list of

files to parse

Parameters:

array

$filelist:

array of paths (strings)

API Tags:

Return:

array(filelist - tutorials, tutorials)

[ Top ]

isIncludeable [line 222]

boolean isIncludeable(
string
$filename 
)

calls http://www.php.net/file_exists for each value in include_path,

then calls http://www.php.net/is_readable when it finds the file

Parameters:

string

$filename:

[ Top ]

parseArgv [line 253]

array parseArgv(
)

Parses $_SERVER['argv'] and creates a setup array

API Tags:

Return:	a setup array
Global:	array $argv: command-line arguments

[ Top ]

readPhpFile [line 578]

void readPhpFile(
string
$path, [
$quietMode = false] 
)

Reads a file and returns it as a string Does basic error checking

file extensions are set in phpdoc.inc

Parameters:

string	$path:
	$quietMode:

API Tags:

Global:	array $_phpDocumentor_cvsphpfile_exts: PHP File extensions, used to validate that $path is a PHP File
Global:	array $_phpDocumentor_phpfile_exts: PHP File extensions in a CVS repository, used to validate that $path is a PHP File

[ Top ]

removeNonMatches [line 780]

string|array removeNonMatches(
array
$dir, string
$match 
)

Removes files from the $dir array that do not match the search string in

$match

Parameters:

array	$dir:	array of filenames (full path)
string	$match:	search string with wildcards

API Tags:

Return:

listing of every file in a directory that matches the search string

Information Tags:

Author:

Greg Beaver <[email protected]>

[ Top ]

_setupIgnore [line 719]

void _setupIgnore(
array
$ignore 
)

Construct the $ignore array

Parameters:

array

$ignore:

strings of files/paths/wildcards to ignore

API Tags:

Access:

protected

Information Tags:

Author:

Greg Beaver <[email protected]>

[ Top ]

Documentation generated on Tue, 24 Oct 2006 09:23:56 -0500 by phpDocumentor 1.3.1

	phpDocumentor

[ class tree: phpDocumentor ] [ index: phpDocumentor ] [ all elements ]