[Feature Request] Create generator for matrix values.

Abierto Apto para principiantes
#497 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
74/100
Tipo de issue
Nueva funcionalidad
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
php
Área
backend

Línea de trabajo

Empieza leyendo MatrixInterface y la implementación de Matrix; luego comprueba cómo se usan y prueban getBlockCount() y getBlockValue(). Añade un generador que produzca índices de fila y columna para los bloques cuyo valor sea 1; se considera terminado cuando los llamadores puedan iterar con foreach como se muestra en el issue y el comportamiento esté cubierto por una prueba.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

When using MatrixInterface, you often write code like this:

$matrix = ...
$blockCount = $matrix->getBlockCount();
for ($rowIndex = 0; $rowIndex < $blockCount; ++$rowIndex) {
    for ($columnIndex = 0; $columnIndex < $blockCount; ++$columnIndex) {
        if (1 === $matrix->getBlockValue($rowIndex, $columnIndex)) {
            // ...
        }
    }
}

It would be nice to create a new function (a generator) that returns the row and column indices only for valid values:

interface MatrixInterface {

    /**
     * @return \Generator<array{0: int, 1: int}>
     */ 
    public function getIndexes(): \Generator;

}

And the implementation:

final readonly class Matrix implements MatrixInterface {

    #[\Override]
    public function getIndexes(): \Generator {
        $blockCount = $this->getBlockCount();
        for ($rowIndex = 0; $rowIndex < $blockCount; ++$rowIndex) {
            for ($columnIndex = 0; $columnIndex < $blockCount; ++$columnIndex) {
                if (1 === $this->getBlockValue($rowIndex, $columnIndex)) {
                   yield [$rowIndex, $columnIndex];
                }
            }
        }
    }
}

Then use as follow:

$matrix = ...
foreach ($matrix->getIndexes() as [$rowIndex, $columnIndex]) {
    // ...
}
Lenguaje dominante
PHP
Estrellas
4.8k
Forks
766
Merge medio
10 h 51 min
PR fusionados (30 d)
1

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de endroid/qr-code

Todos los issues de endroid/qr-code

Issues similares

Más issues de PHP

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.