src.where.comparacion - gamboamartin/where GitHub Wiki

comparacion

Compara los datos proporcionados y devuelve el valor de la clave 'comparacion' si existe, de lo contrario devuelve el valor por defecto.

Signatura

private function comparacion(array|string|null $data, string $default):string

Parámetros

$data (array|string|null): Los datos a comparar, puede ser un array, una cadena o null.

$default (string): El valor por defecto a devolver si la clave 'comparacion' no existe en los datos.

Retorna

• string: El valor de la clave 'comparacion' si existe, de lo contrario el valor por defecto.

Explicación Detallada

1. Definición de la Función

   • La función comparacion es una función privada, lo que significa que solo se puede acceder a ella dentro de la misma clase en la que está definida.
   • La función acepta dos parámetros:
     • $data: Puede ser un array, una cadena de texto, o null.
     • $default: Es una cadena de texto que se devolverá si la clave 'comparacion' no existe en $data.

2. Parámetros de Entrada

   • $data (array|string|null):
     • Este parámetro puede ser de tres tipos: array, cadena de texto, o null.
     • Si $data es un array, la función buscará la clave 'comparacion' dentro de ese array.
     • Si $data es una cadena de texto o null, la función no podrá buscar la clave 'comparacion'.
   • $default (string):
     • Este es el valor por defecto que se devolverá si la clave 'comparacion' no existe en $data.

3. Lógica de la Función

   • La función utiliza el operador de fusión null (??), que verifica si una variable es null. Si no lo es, devuelve su valor; de lo contrario, devuelve un valor por defecto.
   • return $data['comparacion'] ?? $default;:
     • Si $data es un array y contiene la clave 'comparacion', la función devolverá el valor asociado a esta clave.
     • Si $data no es un array, o si es un array que no contiene la clave 'comparacion', la función devolverá el valor de $default.

4. Flujo de Ejecución

   • Cuando se llama a la función comparacion, primero evalúa el parámetro $data.
   • Si $data es un array y contiene la clave 'comparacion', la función devuelve el valor asociado a esa clave.
   • Si $data no es un array válido (es decir, es una cadena de texto o null), o si es un array que no contiene la clave 'comparacion', la función devuelve el valor por defecto $default.

Ejemplos

$datos = ['comparacion' => 'valor1'];
$porDefecto = 'valorDefecto';

$resultado = comparacion($datos, $porDefecto); // Devuelve 'valor1'

$datos = null;
$resultado = comparacion($datos, $porDefecto); // Devuelve 'valorDefecto'

Código de la Función

private function comparacion(array|string|null $data, string $default):string{
        return $data['comparacion'] ?? $default;
    }