View source for Ferreteria/v0.6/clade/Sys/FileSys/Aspect/Ident

{{page/clade/v2
|fam=
{{!}} align=right {{!}} {{l/ver/clade|Sys\FileSys|Aspect}}
{{!}} align=center {{!}} &rarr; {{l/ver/clade|Sys\FileSys\Aspect|Ident}}
{{!}}
&rarr; {{l/ver/clade|Sys\FileSys\Aspect\Ident|Fi}}<br>
&rarr; {{l/ver/clade|Sys\FileSys\Aspect\Ident|Fo}}

|alia=
{{!}}-
{{!}} '''Base'''* [ca,i] {{!!}} {{l/ver/clade/full|p=ferreteria|Sys\FileSys|Aspect}}
{{!}}-
{{!}} '''Node'''* [i] {{!!}} {{l/ver/clade/full|p=ferreteria|Sys\FileSys|Node}}
{{!}}-
{{!}} '''QObj'''* [c,i] {{!!}} {{l/ver/clade/full|p=ferreteria|Data\Mem\QVar|Obj}}
{{!}}-
{{!}} '''QStr'''* [c,i] {{!!}} {{l/ver/clade/full|p=ferreteria|Data\Mem\QVar|Str}}

}}
==Logic==
* Each object starts with a full filespec and uses [https://www.php.net/manual/en/class.splfileinfo.php SplFileInfo] to parse that into pieces as needed.
==Status==
* '''{{fmt/date|2025|11|03}}''' refactoring to use existing filespec system instead of SPL
==Code==
''as of 2025-10-06''
{{fmt/php/block|1=
interface iIdent extends BaseIface {
    // SETUP
    static function FromSpec(string $fs) : self;
    // ACCESS
    function QSFullSpec() : QStrIface;
    function Exists() : bool;
    function SpecFull() : string;     // path/filename.ext
    function SpecPath() : string;     // path
    function SpecNameCore() : string; // filename (no path, no ext)
    function SpecExtn() : string;     // .ext
    function SpecNameExt() : string;  // filename.ext
}
class caIdent extends BaseClass implements iIdent {

    // ++ SETUP ++ //

    public static function FromSpec(string $fs) : iIdent {
        $oThis = new static;
        $oThis->QSFullSpec()->SetIt($fs);
        return $oThis;
    }
    public static function FromQStr(QStrIface $os) : iIdent {
        $oThis = new static;
        $oThis->QSFullSpec($os);
        return $oThis;
    }

    // -- SETUP -- //
    // ++ ACCESS ++ //

    private $osStr = NULL;
    public function QSFullSpec(?QStrIface $os=NULL) : QStrIface {
        if (is_object($os)) {
            $this->osStr = $os;
        } else {
            if (is_null($this->osStr)) {
                $this->osStr = QStrClass::AsNew();
            }
            $os = $this->osStr;
        }
        return $os;
    }

    public function Exists() : bool { return file_exists($this->QSFullSpec()->GetIt()); }

    public function SpecFull() : string { return $this->QSFullSpec()->GetIt(); }
    public function SpecPath() : string { return $this->NativeSplInfo()->getPath(); }
    public function SpecNameCore() : string { return $this->NativeSplInfo()->getBasename('.'.$this->SpecExtn()); }
    public function SpecExtn() : string { return $this->NativeSplInfo()->getExtension(); }
    public function SpecNameExt() : string { return $this->NativeSplInfo()->getFilename(); }

    // ++ ACCESS: internal ++ //

    private $onInfo = NULL;
    protected function NativeSplInfo() : SplFileInfo { return $this->onInfo ?? ($this->onInfo = new SplFileInfo($this->QSFullSpec()->GetIt())); }

    public function Size() : int{{!}}false { return $this->NativeSplInfo()->getSize(); }

    // -- ACCESS -- //
    // ++ STRUCT ++ //

    protected function NewNode() : NodeIface {
        $oNode = new ($this->NodeClass());
        $oNode->Ident($this);
        return $oNode;
    }

    // -- STRUCT -- //
}
}}