ParamTag

namespace

bhenk\doc2rst\tag

predicates

Cloneable | Instantiable

implements

Stringable | TagInterface

extends

AbstractTypeTag

hierarchy

ParamTag -> AbstractTypeTag -> AbstractLinkTag -> AbstractTag

known subclasses

VarTag

Represents the param tag

syntax

@param ["Type"] $[name] [<description>]

see also

PSR-19 @param


Constants

ParamTag::TAG

predicates

public

@inheritdoc

var string TAG - the name of this tag

@inheritdoc from AbstractTag::TAG

string(6) "@param"

Constructor

ParamTag::__construct

predicates

public | constructor

inherited from

AbstractTag::__construct

Construct a new Tag

The param $tag_string should include the at-symbol @, tag name and possibly curly braces. The string should follow the syntax of the specific Tag being constructed.

public function __construct(
      Parameter #0 [ <optional> ?string $tag_string = '' ]
 )
param ?string $tag_string - string following syntax of this Tag class

Methods

ParamTag::getTagName

predicates

public

implements

TagInterface::getTagName

@inheritdoc

Gets the tag-name of this Tag

return string - tag-name of this Tag

@inheritdoc from method TagInterface::getTagName

public function getTagName(): string
return string - name of this Tag

ParamTag::render

predicates

public

implements

AbstractTag::render

Renders a named type Tag

syntax

@tag_name ["Type"] $[name] [<description>]
public function render(): void
return void

ParamTag::__toString

predicates

public

implements

Stringable::__toString

Returns a reStructuredText representation of the contents of this Tag

public function __toString(): string
return string - reStructuredText representation of contents

ParamTag::getName

predicates

public

public function getName(): ?string
return ?string

ParamTag::setName

predicates

public

public function setName(
      Parameter #0 [ <required> ?string $name ]
 ): void
param ?string $name
return void

ParamTag::getType

predicates

public

inherited from

AbstractTypeTag::getType

public function getType(): ?string
return ?string

ParamTag::setType

predicates

public

inherited from

AbstractTypeTag::setType

public function setType(
      Parameter #0 [ <required> ?string $type ]
 ): void
param ?string $type
return void

ParamTag::getUri

predicates

public

inherited from

AbstractLinkTag::getUri

public function getUri(): ?string
return ?string

ParamTag::setUri

predicates

public

inherited from

AbstractLinkTag::setUri

public function setUri(
      Parameter #0 [ <required> ?string $uri ]
 ): void
param ?string $uri
return void

ParamTag::getDescription

predicates

public

inherited from

AbstractLinkTag::getDescription

public function getDescription(): ?string
return ?string

ParamTag::setDescription

predicates

public

inherited from

AbstractLinkTag::setDescription

public function setDescription(
      Parameter #0 [ <required> ?string $description ]
 ): void
param ?string $description
return void

ParamTag::getTagString

predicates

public

inherited from

AbstractTag::getTagString

Get the $tag_string

public function getTagString(): string
return string - string with which this Tag was constructed

ParamTag::getLine

predicates

public

inherited from

AbstractTag::getLine

Get the content of the $tag_string without the tag name and curly braces

public function getLine(): string
return string - content of the $tag_string

ParamTag::getDisplayName

predicates

public

implements

TagInterface::getDisplayName

inherited from

AbstractTag::getDisplayName

@inheritdoc

Get the short version of this tagname, without the at-sign (@)

return string - short version of this tagname

@inheritdoc from method TagInterface::getDisplayName

public function getDisplayName(): string
return string

ParamTag::isInline

predicates

public

implements

TagInterface::isInline

inherited from

AbstractTag::isInline

@inheritdoc

Is this an inline tag

Is this an inline tag (with curly braces) or does this tag appear at the start of a line.

return bool - true if this is an inline link, false otherwise

@inheritdoc from method TagInterface::isInline

public function isInline(): bool
return bool

ParamTag::getTagLength

predicates

public

implements

TagInterface::getTagLength

inherited from

AbstractTag::getTagLength

@inheritdoc

Get the length (in characters) of this tagname

return int - length (in characters) of this tagname

@inheritdoc from method TagInterface::getTagLength

public function getTagLength(): int
return int

ParamTag::getGroupWidth

predicates

public

implements

TagInterface::getGroupWidth

inherited from

AbstractTag::getGroupWidth

@inheritdoc

Get the width (in characters) of the group in which this Tag will be displayed

return int - width (in characters) or -1 if not yet set

@inheritdoc from method TagInterface::getGroupWidth

public function getGroupWidth(): int
return int

ParamTag::setGroupWidth

predicates

public

implements

TagInterface::setGroupWidth

inherited from

AbstractTag::setGroupWidth

@inheritdoc

Set the width (in characters) of the group in which this Tag will be displayed

param int $max_width - width (in characters)
return void

@inheritdoc from method TagInterface::setGroupWidth

public function setGroupWidth(
      Parameter #0 [ <required> int $max_width ]
 ): void
param int $max_width
return void

ParamTag::toRst

predicates

public

implements

TagInterface::toRst

inherited from

AbstractTag::toRst

@inheritdoc

Express this Tag in reStructuredText

return string - reStructuredText representation of this Tag

@inheritdoc from method TagInterface::toRst

public function toRst(): string
return string

Fri, 31 Mar 2023 13:22:46 +0000