peripherad

Back Back Up Advanced Editor

<?php

declare(strict_types=1);

/**
 * This file is part of phpDocumentor.
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 *
 * @link http://phpdoc.org
 */

namespace phpDocumentor\Reflection\Php;

use Override;
use phpDocumentor\Reflection\DocBlock;
use phpDocumentor\Reflection\Element;
use phpDocumentor\Reflection\Fqsen;
use phpDocumentor\Reflection\Location;
use phpDocumentor\Reflection\Metadata\MetaDataContainer as MetaDataContainerInterface;

use function is_string;
use function trigger_error;

use const E_USER_DEPRECATED;

/**
 * Descriptor representing a constant
 *
 * @api
 */
final class Constant implements Element, MetaDataContainerInterface, AttributeContainer
{
    use MetadataContainer;
    use HasAttributes;

private readonly Location $location;

private readonly Location $endLocation;

private readonly Visibility $visibility;

/**
     * Initializes the object.
     */
    public function __construct(
        private readonly Fqsen $fqsen,
        private readonly DocBlock|null $docBlock = null,
        private Expression|string|null $value = null,
        Location|null $location = null,
        Location|null $endLocation = null,
        Visibility|null $visibility = null,
        private readonly bool $final = false,
    ) {
        $this->location = $location ?: new Location(-1);
        $this->endLocation = $endLocation ?: new Location(-1);
        $this->visibility = $visibility ?: new Visibility(Visibility::PUBLIC_);

if (!is_string($this->value)) {
            return;
        }

trigger_error(
            'Constant values should be of type Expression, support for strings will be '
            . 'removed in 6.x',
            E_USER_DEPRECATED,
        );
        $this->value = new Expression($this->value, []);
    }

/**
     * Returns the expression value for this constant.
     */
    public function getValue(bool $asString = true): Expression|string|null
    {
        if ($this->value === null) {
            return null;
        }

if ($asString) {
            trigger_error(
                'The expression value will become of type Expression by default',
                E_USER_DEPRECATED,
            );

return (string) $this->value;
        }

return $this->value;
    }

/**
     * Returns the Fqsen of the element.
     */
    #[Override]
    public function getFqsen(): Fqsen
    {
        return $this->fqsen;
    }

/**
     * Returns the name of the element.
     */
    #[Override]
    public function getName(): string
    {
        return $this->fqsen->getName();
    }

/**
     * Returns DocBlock of this constant if available.
     */
    public function getDocBlock(): DocBlock|null
    {
        return $this->docBlock;
    }

public function getLocation(): Location
    {
        return $this->location;
    }

public function getEndLocation(): Location
    {
        return $this->endLocation;
    }

public function getVisibility(): Visibility
    {
        return $this->visibility;
    }

public function isFinal(): bool
    {
        return $this->final;
    }
}