src/Traits/FieldCollectionCommomMethods.php
public function collectionGetIndexOfValue($v) : ?int
    {
        $r = null;
        $useCompare = $this->individualValue_RetrieveInStorageFormat($v);

        if ($useCompare !== null) {

            $sType = $this->identifySimpleType();
            if ($sType === "reference") {
                $useCompare = $this->createStringToCompareReferences($useCompare);
            } elseif ($sType === "Real") {
                $useCompare = (string)$useCompare;
            } elseif ($sType === "DateTime") {
                $useCompare = $useCompare->format("Y-m-d H:i:s");
            }
            

            foreach ($this->value as $i => $vv) {
                if ($r === null) {
                    $vvCompare = $vv;
                    
                    if ($sType === "reference") {
                        $vvCompare = $this->createStringToCompareReferences($vv);
                    } elseif ($sType === "Real") {
                        $vvCompare = (string)$vv;
                    } elseif ($sType === "DateTime") {
                        $vvCompare = $vv->format("Y-m-d H:i:s");
                    }

                    if ($useCompare === $vvCompare) { $r = $i; }
                }
            }
        }
        return $r;
    }
public function collectionGetIndexOfValue($v) : ?int
    {
        $r = null;
        $useCompare = $this->individualValue_RetrieveInStorageFormat($v);

        if ($useCompare !== null) {

            $sType = $this->identifySimpleType();
            if ($sType === "reference") {
                $useCompare = $this->createStringToCompareReferences($useCompare);
            } elseif ($sType === "Real") {
                $useCompare = (string)$useCompare;
            } elseif ($sType === "DateTime") {
                $useCompare = $useCompare->format("Y-m-d H:i:s");
            }
            

            foreach ($this->value as $i => $vv) {
                if ($r === null) {
                    $vvCompare = $vv;
                    
                    if ($sType === "reference") {
                        $vvCompare = $this->createStringToCompareReferences($vv);
                    } elseif ($sType === "Real") {
                        $vvCompare = (string)$vv;
                    } elseif ($sType === "DateTime") {
                        $vvCompare = $vv->format("Y-m-d H:i:s");
                    }

                    if ($useCompare === $vvCompare) { $r = $i; }
                }
            }
        }
        return $r;
    }
Procura pelo valor indicado na coleção atualmente armazenada
e retorna o índice do mesmo.
Valores que não estão aptos a serem armazenados neste campo irão
sempre retornar "null".

Havendo mais de 1 valor igual na coleção, retornará o índice
da primeira ocorrência encontrada.

@param       mixed $v
Valor que será verificado.

@return      ?int