DocComment

MMO\doc\helpers · 1 symbole · générée le 27 Oct 2026

class

DocComment

class MMO\doc\helpers\DocComment implements MMO\core\interfaces\iArray, Stringable use MMO\core\classes\tArray

Espace de noms: MMO\doc\helpers
Implémente: iArray, Stringable
Utilise les traits: tArray

Index

	content
	texts
	add($text)
	addText($text)
	clear()	Empty the underlying content, keeping the object itself.
	count()	\Countable::count
	Description($text, $includeSummary) static
	getDescription($includeSummary)
	getIterator()	\IteratorAggregate::getIterator
	getParam($name)
	getSummary()
	getTexts()
	isEmpty()
	jsonSerialize()	\JsonSerializable::jsonSerialize -- the raw content is returned as-is (not recursively converted), so json_encode() relies on any nested iArray values being JsonSerializable themselves.
	keys()
	loadArray($data)	Load every entry of a plain array into the content, through `offsetSet` (so any offsetSet() override defined by the class using this trait, e.g.
	offsetExists($key)	\ArrayAccess::offsetExists
	offsetGet($key)	\ArrayAccess::offsetGet
	offsetSet($key, $value)	\ArrayAccess::offsetSet -- a null $key appends (`$bag[] = $value`), like a plain PHP array.
	offsetUnset($key)	\ArrayAccess::offsetUnset -- on a list (sequential integer keys, as produced by `$bag[] = ...`), the element is spliced out (closing the gap and reindexing), matching \unset() semantics on a plain …
	parseInlineTags($text)
	render($opts)
	Summary($text) static
	toArray()	Convert the content to a plain array, recursively converting any nested `iArray` value (e.g.
	__construct($text)
	__toString()

Propriétés2

content

protected $content = []

texts

protected array $texts = []

Type: array

Méthodes24

add($text)

DocComment.php:33

function add(string $text): void

$text	string
retourne	void

addText($text)

DocComment.php:98

protected function addText(string $text): void

$text	string
retourne	void

clear()

tArray.php:25

Empty the underlying content, keeping the object itself.

function clear()

retourne

$bag->clear(); // count($bag) === 0 afterwards

count()

tArray.php:90

\Countable::count

function count(): int

retourne

int

Description($text, $includeSummary)

staticDocComment.php:27

static function Description(string $text, bool $includeSummary = true): ?string

$text	string
$includeSummary = true	bool
retourne	null \| string

getDescription($includeSummary)

DocComment.php:71

function getDescription(bool $includeSummary = false): string

$includeSummary = false	bool
retourne	string

getIterator()

tArray.php:97

\IteratorAggregate::getIterator

function getIterator(): Traversable

retourne

Traversable

getParam($name)

DocComment.php:16

function getParam(string $name): ?MMO\doc\helpers\DocTag

$name	string
retourne	null \| DocTag

getSummary()

DocComment.php:67

function getSummary(): ?string

retourne

null | string

getTexts()

DocComment.php:63

function getTexts(): array

retourne

array

isEmpty()

tArray.php:33

function isEmpty()

retourne

true if the underlying content has no elements

$bag->isEmpty(); // true right after clear(), false as soon as an item is set

jsonSerialize()

tArray.php:43

\JsonSerializable::jsonSerialize -- the raw content is returned as-is (not recursively converted), so json_encode() relies on any nested iArray values being JsonSerializable themselves.

function jsonSerialize(): mixed

retourne

mixed

json_encode($bag); // e.g. '{"x":1,"0":2}'

keys()

tArray.php:82

function keys(): array

retourne

array

the list of keys currently set

$bag->keys(); // e.g. ['x', 0]

loadArray($data)

tArray.php:71

Load every entry of a plain array into the content, through offsetSet (so any offsetSet() override defined by the class using this trait, e.g. for validation or type coercion, is honored for every entry).

function loadArray(array $data): static

$data	array
retourne	static	$this, for chaining

$bag->loadArray(['x' => 1, 'y' => 2]); // equivalent to $bag['x'] = 1; $bag['y'] = 2;

offsetExists($key)

tArray.php:130

\ArrayAccess::offsetExists

function offsetExists(mixed $key): bool

$key	mixed
retourne	bool

offsetGet($key)

tArray.php:115

\ArrayAccess::offsetGet

function offsetGet(mixed $key): mixed

$key	mixed
retourne	mixed

offsetSet($key, $value)

tArray.php:122

\ArrayAccess::offsetSet -- a null $key appends ($bag[] = $value), like a plain PHP array.

function offsetSet(mixed $key, mixed $value): void

$key	mixed
$value	mixed
retourne	void

offsetUnset($key)

tArray.php:107

\ArrayAccess::offsetUnset -- on a list (sequential integer keys, as produced by $bag[] = ...), the element is spliced out (closing the gap and reindexing), matching \unset() semantics on a plain PHP list; on an associative array, the key is simply removed.

function offsetUnset(mixed $key): void

$key	mixed
retourne	void

unset($bag[0]); // on a list: every following index shifts down by one, like array_splice()

parseInlineTags($text)

DocComment.php:114

protected function parseInlineTags(string $text): void

$text	string
retourne	void

render($opts)

DocComment.php:84

function render(array $opts = []): string

$opts = []	array
retourne	string

Summary($text)

staticDocComment.php:23

static function Summary(string $text): ?string

$text	string
retourne	null \| string

toArray()

tArray.php:56

Convert the content to a plain array, recursively converting any nested iArray value (e.g. another object using this same trait) into its own plain-array form as well.

function toArray(): array

retourne

array

$inner = new Bag(); $inner['a'] = 1; $outer = new Bag(); $outer['inner'] = $inner; $outer->toArray(); // ['inner' => ['a' => 1]] -- $inner is recursively expanded, not left as an object

__construct($text)

DocComment.php:12

function __construct(string $text = '')

$text = ''

string

__toString()

DocComment.php:92

function __toString(): string

retourne

string