Child classes:
- parserCData
- Represents <![CDATA[ ]]> sections.
- parserXMLDocBookTag
- a standard XML DocBook Tag
- parserCode
- Used for <code> in a description
- parserPre
- Used for <pre> in a description
- parserB
- Used for <b> in a description
- parserI
- Used for <i> in a description
- parserDescVar
- Used for <var> in a description
- parserSamp
- Used for <samp> in a description
- parserKbd
- Used for <kbd> in a description
- parserBr
- Used for <br> in a description
- parserList
- Used for lists <ol> and <ul>
- parserTag
- used to represent standard tags like @access, etc.
- parserDesc
- represents a short or long description in a DocBlock (parserDocBlock)
Inherited Variables
Inherited Constants
Inherited Methods
Class: parserBase
- parserBase::getType()
- gets the type
- parserBase::getValue()
- gets the value
- parserBase::setValue()
- sets the given value
Class Details
Used to represent strings that contain inline tags, so that they can be properly parsed at link time
Tags:
- author - Gregory Beaver <[email protected]>
- version - Release: @VER@
- copyright - 2002-2008 Gregory Beaver
- link - http://pear.php.net/PhpDocumentor
- link - http://www.phpdoc.org
- todo - CS cleanup - change package to PhpDocumentor
- since - 1.0rc1
- license - LGPL
[ Top ]
Class Variables
$type = '_string'
[line 784]
Type is used by many functions to skip the hassle of if phpDocumentor_get_class($blah) == 'parserBlah'...
always '_string'
Type: string
Overrides: Array
[ Top ]
$value = array()
[line 795]
array of strings and parserInlineTags
Format: array(string1,string2,parserInlineTag1,string3,parserInlineTag2,...)
Type: array
Overrides: Array
[ Top ]
Class Methods
add
void add(
mixed
$stringOrInlineTag)
[line 804]
equivalent to the . operator ($a = $b . $c)
Overridden in child classes as:
- parserXMLDocBookTag::add()
- Add contents to this tag.
Parameters:
- mixed $stringOrInlineTag - either a string or a parserInlineTag
[ Top ]
Convert
string Convert(
Converter
&$converter, [bool
$postprocess = true], [bool
$trim = true])
[line 924]
Use to convert the string to a real string with all inline tags parsed and linked
Tags:
- see - Converter::returnSee()
- todo - CS cleanup - rename to convert for camelCase rule
Overridden in child classes as:
- parserCData::Convert()
- calls the output conversion
- parserXMLDocBookTag::Convert()
- calls the output conversion
- parserCode::Convert()
- performs the conversion of code tags
- parserPre::Convert()
- performs the conversion of code tags
- parserB::Convert()
- performs the conversion of bold tags
- parserI::Convert()
- performs the conversion of italic tags
- parserDescVar::Convert()
- performs the conversion of variable tags
- parserSamp::Convert()
- performs the conversion of sample tags
- parserKbd::Convert()
- performs the conversion of keyboard tags
- parserBr::Convert()
- performs the conversion of linebreak tags
- parserList::Convert()
- performs the conversion of list tags
- parserTag::Convert()
- Perform the output conversion on this parserTag using the output converter that is passed in
- parserNameTag::Convert()
- process this tag through the given output converter
- parserAccessTag::Convert()
- process this tag through the given output converter
- parserReturnTag::Convert()
- process this tag through the given output converter (sets up the $converted_returnType)
- parserSeeTag::Convert()
- process this tag through the given output converter
- parserUsesTag::Convert()
- Return a link to documentation for other element, and description of how it is used
- parserUsedByTag::Convert()
- process this tag through the given output converter
- parserTutorialTag::Convert()
- process this tag through the given output converter
- parserFileSourceTag::Convert()
- Return a link to the highlighted source and generate the source
Parameters:
- Converter &$converter - the output converter
- bool $postprocess - true if one needs to postprocess
- bool $trim - false if the output should not be trimmed
[ Top ]
getString
string getString(
[bool
$trim = true])
[line 896]
return the string unconverted (all inline tags are taken out - this should only be used in pre-parsing to see if any other text is in the string)
Tags:
- return - trimmed value
- uses - parserInlineTag::getString() - removes inline tag length, as it is indeterminate until conversion.
Overridden in child classes as:
- parserTag::getString()
- Returns the text minus any inline tags
- parserAccessTag::getString()
- No inline tags are possible, returns 'public', 'protected' or 'private'
Parameters:
- bool $trim - whether to trim the string
[ Top ]
hasInlineTag
bool hasInlineTag(
)
[line 835]
Determine whether the string contains any inline tags
Tags:
- tutorial - phpDocumentor Inline tags
Parameters:
[ Top ]
setSource
void setSource(
string|array
$source)
[line 853]
Pass source code to any {@source} tags contained within the string for later conversion.
Parameters:
- string|array $source - source code ready to be highlighted
[ Top ]
trimmedStrlen
integer trimmedStrlen(
)
[line 868]
equivalent to trim(strlen($string))
Tags:
- return - length of the string this object represents
Parameters:
[ Top ]