TitleValue.php

Go to the documentation of this file.

<?php
class TitleValue {
    protected $namespace;

    protected $dbkey;

    protected $fragment;

    public function __construct( $namespace, $dbkey, $fragment = '' ) {
        if ( !is_int( $namespace ) ) {
            throw new InvalidArgumentException( '$namespace must be an integer' );
        }

        if ( !is_string( $dbkey ) ) {
            throw new InvalidArgumentException( '$dbkey must be a string' );
        }

        // Sanity check, no full validation or normalization applied here!
        if ( preg_match( '/^_|[ \r\n\t]|_$/', $dbkey ) ) {
            throw new InvalidArgumentException( '$dbkey must be a valid DB key: ' . $dbkey );
        }

        if ( !is_string( $fragment ) ) {
            throw new InvalidArgumentException( '$fragment must be a string' );
        }

        if ( $dbkey === '' ) {
            throw new InvalidArgumentException( '$dbkey must not be empty' );
        }

        $this->namespace = $namespace;
        $this->dbkey = $dbkey;
        $this->fragment = $fragment;
    }

    public function getNamespace() {
        return $this->namespace;
    }

    public function getFragment() {
        return $this->fragment;
    }

    public function getDBkey() {
        return $this->dbkey;
    }

    public function getText() {
        return str_replace( '_', ' ', $this->getDBkey() );
    }

    public function createFragmentTitle( $fragment ) {
        return new TitleValue( $this->namespace, $this->dbkey, $fragment );
    }

    public function __toString() {
        $name = $this->namespace . ':' . $this->dbkey;

        if ( $this->fragment !== '' ) {
            $name .= '#' . $this->fragment;
        }

        return $name;
    }
}