🎨 Normalize 'namespace' style.

Author: nelson6e65

src/Collections/Collection.php

@@ -17,70 +17,69 @@
  * @license   http://www.opensource.org/licenses/mit-license.php The MIT License (MIT)
  * */
 
-namespace NelsonMartell\Collections {
+namespace NelsonMartell\Collections;
+
+use \Iterator;
+
+/**
+ * Define métodos para manipular colecciones de objetos.
+ *
+ * @author Nelson Martell <nelson6e65@gmail.com>
+ * */
+interface ICollection extends Iterator
+{
 
-    use \Iterator;
 
     /**
-     * Define métodos para manipular colecciones de objetos.
+     * Obtiene el número de elementos incluidos en la colección.
+     * Si extiende la clase NelsonMartell.Object, puede accederse desde la
+     * propiedad `Count`.
      *
-     * @author Nelson Martell <nelson6e65@gmail.com>
+     * @return integer
+     * @see    NelsonMartell\Object
      * */
-    interface ICollection extends Iterator
-    {
-
+    public function getCount();
 
-        /**
-         * Obtiene el número de elementos incluidos en la colección.
-         * Si extiende la clase NelsonMartell.Object, puede accederse desde la
-         * propiedad `Count`.
-         *
-         * @return integer
-         * @see    NelsonMartell\Object
-         * */
-        public function getCount();
 
-
-        /**
-         * Agrega un elemento a la colección.
-         *
-         * @param mixed $item Objeto que se va a agregar.
-         *
-         * @return void
-         * */
-        public function add($item);
+    /**
+     * Agrega un elemento a la colección.
+     *
+     * @param mixed $item Objeto que se va a agregar.
+     *
+     * @return void
+     * */
+    public function add($item);
 
 
-        /**
-         * Quita todos los elementos de la colección.
-         * La propiedad Count se debe establecer en 0 y deben liberarse las
-         * referencias a otros objetos desde los elementos de la colección.
-         *
-         * @return void
-         * */
-        public function clear();
+    /**
+     * Quita todos los elementos de la colección.
+     * La propiedad Count se debe establecer en 0 y deben liberarse las
+     * referencias a otros objetos desde los elementos de la colección.
+     *
+     * @return void
+     * */
+    public function clear();
 
 
-        /**
-         * Determina si la colección contiene al elemento especificado.
-         *
-         * @param mixed $item Objeto que se va a buscar.
-         *
-         * @return boolean `true` si $item se encuentra; en caso contrario, `false`.
-         * */
-        public function contains($item);
+    /**
+     * Determina si la colección contiene al elemento especificado.
+     *
+     * @param mixed $item Objeto que se va a buscar.
+     *
+     * @return boolean `true` si $item se encuentra; en caso contrario, `false`.
+     * */
+    public function contains($item);
 
 
-        /**
-         * Quita, si existe, la primera aparición de un objeto específico de la
-         * colección.
-         *
-         * @param mixed $item Objeto que se va a quitar.
-         *
-         * @return boolean `true` si el elemento se ha quitado correctamente; en
-         *   caso contrario, `false`. Este método también devuelve `false` si no
-         *   se encontró.
-         * */
-        public function remove($item);
-    }
+    /**
+     * Quita, si existe, la primera aparición de un objeto específico de la
+     * colección.
+     *
+     * @param mixed $item Objeto que se va a quitar.
+     *
+     * @return boolean `true` si el elemento se ha quitado correctamente; en
+     *   caso contrario, `false`. Este método también devuelve `false` si no
+     *   se encontró.
+     * */
+    public function remove($item);
 }

src/Collections/ICollection.php

@@ -17,53 +17,52 @@
  * @license   http://www.opensource.org/licenses/mit-license.php The MIT License (MIT)
  * */
 
-namespace NelsonMartell\Collections {
+namespace NelsonMartell\Collections;
+
+/**
+ * Representa una colección de objetos a los que se puede tener acceso por
+ * un índice.
+ *
+ * @author Nelson Martell <nelson6e65@gmail.com>
+ * */
+interface IList extends ICollection
+{
+
 
     /**
-     * Representa una colección de objetos a los que se puede tener acceso por
-     * un índice.
+     * Determina el índice de un elemento específico de la lista.
+     * Si un objeto aparece varias veces en la lista, el método indexOf
+     * siempre devolverá la primera instancia encontrada.
+     *
+     * @param mixed $item Objeto que se va a buscar.
      *
-     * @author Nelson Martell <nelson6e65@gmail.com>
+     * @return integer Índice de $item si se encuentra en la lista; en caso
+     *   contrario, -1.
      * */
-    interface IList extends ICollection
-    {
-
-
-        /**
-         * Determina el índice de un elemento específico de la lista.
-         * Si un objeto aparece varias veces en la lista, el método indexOf
-         * siempre devolverá la primera instancia encontrada.
-         *
-         * @param mixed $item Objeto que se va a buscar.
-         *
-         * @return integer Índice de $item si se encuentra en la lista; en caso
-         *   contrario, -1.
-         * */
-        public function indexOf($item);
+    public function indexOf($item);
 
 
-        /**
-         * Inserta un elemento en la lista, en el índice especificado.
-         *
-         * @param integer $index Índice de base cero en el que debe insertarse
-         *   $item.
-         * @param mixed   $item  Objeto que se va a insertar.
-         *
-         * @return void
-         * */
-        public function insert($index, $item);
+    /**
+     * Inserta un elemento en la lista, en el índice especificado.
+     *
+     * @param integer $index Índice de base cero en el que debe insertarse
+     *   $item.
+     * @param mixed   $item  Objeto que se va a insertar.
+     *
+     * @return void
+     * */
+    public function insert($index, $item);
 
 
-        /**
-         * Quita el elemento del índice especificado.
-         *
-         * @param integer $index Índice de base cero del elemento que se va a
-         *   quitar.
-         *
-         * @return boolean `true` si el elemento se ha quitado correctamente; en
-         *   caso contrario, `false`. Este método también devuelve `false` si no
-         *   se encontró.
-         * */
-        public function removeAt($index);
-    }
+    /**
+     * Quita el elemento del índice especificado.
+     *
+     * @param integer $index Índice de base cero del elemento que se va a
+     *   quitar.
+     *
+     * @return boolean `true` si el elemento se ha quitado correctamente; en
+     *   caso contrario, `false`. Este método también devuelve `false` si no
+     *   se encontró.
+     * */
+    public function removeAt($index);
 }

src/Collections/IList.php

@@ -17,49 +17,48 @@
  * @license   http://www.opensource.org/licenses/mit-license.php The MIT License (MIT)
  * */
 
-namespace NelsonMartell {
+namespace NelsonMartell;
+
+/**
+ * Provee métodos para comparar posición relativa de instancia.
+ *
+ * @author Nelson Martell <nelson6e65@gmail.com>
+ * */
+interface IComparable
+{
 
     /**
-     * Provee métodos para comparar posición relativa de instancia.
+     * Determina la posición relativa de esta instancia con respecto al objeto especificado.
+     *
+     *
+     * @param mixed $other Objeto con el cuál se va a comparar posición relativa de esta instancia.
      *
-     * @author Nelson Martell <nelson6e65@gmail.com>
+     * @return integer|null
+     *   Debe devolver:
+     *   - ``= 0`` si esta instancia se considera equivalente a $other;
+     *   - ``> 0`` si esta instancia se considera mayor a $other;
+     *   - ``< 0`` si esta instancia se considera menor a $other.
+     *   - ``null`` si esta instancia no se puede comparar a $other.
+     *
+     * @see IComparer::compare()
      * */
-    interface IComparable
-    {
-
-        /**
-         * Determina la posición relativa de esta instancia con respecto al objeto especificado.
-         *
-         *
-         * @param mixed $other Objeto con el cuál se va a comparar posición relativa de esta instancia.
-         *
-         * @return integer|null
-         *   Debe devolver:
-         *   - ``= 0`` si esta instancia se considera equivalente a $other;
-         *   - ``> 0`` si esta instancia se considera mayor a $other;
-         *   - ``< 0`` si esta instancia se considera menor a $other.
-         *   - ``null`` si esta instancia no se puede comparar a $other.
-         *
-         * @see IComparer::compare()
-         * */
-        public function compareTo($other);
+    public function compareTo($other);
 
-        /**
-         * Determina la posición relativa del objeto de la izquierda con respecto al de la derecha.
-         * Puede usarse como segundo argumento en la función de ordenamiento de arrays ``usort()``.
-         *
-         * @param mixed $left  Objeto al que se le va a determinar la posición relativa.
-         * @param mixed $right Objeto con el cuál se va a comparar posición relativa del de la izquierda.
-         *
-         * @return integer|null
-         *   Debe devolver:
-         *   - ``= 0`` si $left se considera equivalente a $right;
-         *   - ``> 0`` si $left se considera mayor a $right;
-         *   - ``< 0`` si $left se considera menor a $right.
-         *   - ``null`` si no se pueden comparar entre sí. (Al usar ``usort()`` se considerarán equivalentes)
-         * @see IComparer::compare()
-         * @deprecated since v0.6.0; implement ``NelsonMartell\IComparer`` instead.
-         * */
-        public static function compare($left, $right);
-    }
+    /**
+     * Determina la posición relativa del objeto de la izquierda con respecto al de la derecha.
+     * Puede usarse como segundo argumento en la función de ordenamiento de arrays ``usort()``.
+     *
+     * @param mixed $left  Objeto al que se le va a determinar la posición relativa.
+     * @param mixed $right Objeto con el cuál se va a comparar posición relativa del de la izquierda.
+     *
+     * @return integer|null
+     *   Debe devolver:
+     *   - ``= 0`` si $left se considera equivalente a $right;
+     *   - ``> 0`` si $left se considera mayor a $right;
+     *   - ``< 0`` si $left se considera menor a $right.
+     *   - ``null`` si no se pueden comparar entre sí. (Al usar ``usort()`` se considerarán equivalentes)
+     * @see IComparer::compare()
+     * @deprecated since v0.6.0; implement ``NelsonMartell\IComparer`` instead.
+     * */
+    public static function compare($left, $right);
 }

src/IComparable.php

@@ -17,33 +17,32 @@
  * @license   http://www.opensource.org/licenses/mit-license.php The MIT License (MIT)
  * */
 
-namespace NelsonMartell {
+namespace NelsonMartell;
 
+/**
+ * Provee métodos para comparar posición relativa entre objetos.
+ *
+ * @author Nelson Martell <nelson6e65@gmail.com>
+ * @see IComparable
+ * */
+interface IComparer
+{
     /**
-     * Provee métodos para comparar posición relativa entre objetos.
+     * Compara dos objetos y devuelve un valor que indica si uno es menor, igual o mayor que el otro.
+     *
+     * Puede usarse como segundo argumento en la función de ordenamiento de arrays ``usort()``.
+     *
+     * @param mixed $left  Objeto al que se le va a determinar la posición relativa.
+     * @param mixed $right Objeto con el cuál se va a comparar posición relativa del de la izquierda.
      *
-     * @author Nelson Martell <nelson6e65@gmail.com>
-     * @see IComparable
+     * @return integer|null
+     *   Debe devolver:
+     *   - ``= 0`` si $left se considera equivalente a $right;
+     *   - ``> 0`` si $left se considera mayor a $right;
+     *   - ``< 0`` si $left se considera menor a $right.
+     *   - ``null`` si no se pueden comparar entre sí. (Al usar ``usort()`` se considerarán equivalentes)
+     * @see \usort()
+     * @see IComparable::compareTo
      * */
-    interface IComparer
-    {
-        /**
-         * Compara dos objetos y devuelve un valor que indica si uno es menor, igual o mayor que el otro.
-         *
-         * Puede usarse como segundo argumento en la función de ordenamiento de arrays ``usort()``.
-         *
-         * @param mixed $left  Objeto al que se le va a determinar la posición relativa.
-         * @param mixed $right Objeto con el cuál se va a comparar posición relativa del de la izquierda.
-         *
-         * @return integer|null
-         *   Debe devolver:
-         *   - ``= 0`` si $left se considera equivalente a $right;
-         *   - ``> 0`` si $left se considera mayor a $right;
-         *   - ``< 0`` si $left se considera menor a $right.
-         *   - ``null`` si no se pueden comparar entre sí. (Al usar ``usort()`` se considerarán equivalentes)
-         * @see \usort()
-         * @see IComparable::compareTo
-         * */
-        public static function compare($left, $right);
-    }
+    public static function compare($left, $right);
 }