TheAlgorithms/Python · error · ValueError

Move is out of bounds for a matrix.

Error message

Move is out of bounds for a matrix.

What it means

Error "Move is out of bounds for a matrix." thrown in TheAlgorithms/Python.

Source

Thrown at matrix/matrix_based_game.py:102

    for row in matrix:
        if len(row) != size:
            msg = f"Each row in the matrix must have exactly {size} characters."
            raise ValueError(msg)
        if not all(char.isalnum() for char in row):
            raise ValueError("Matrix rows can only contain letters and numbers.")


def validate_moves(moves: list[tuple[int, int]], size: int) -> None:
    """
    >>> validate_moves([(1, 2), (-1, 0)], 3)
    Traceback (most recent call last):
        ...
    ValueError: Move is out of bounds for a matrix.
    """
    for move in moves:
        x, y = move
        if not (0 <= x < size and 0 <= y < size):
            raise ValueError("Move is out of bounds for a matrix.")


def parse_moves(input_str: str) -> list[tuple[int, int]]:
    """
    >>> parse_moves("0 1, 1 1")
    [(0, 1), (1, 1)]
    >>> parse_moves("0 1, 1 1, 2")
    Traceback (most recent call last):
        ...
    ValueError: Each move must have exactly two numbers.
    >>> parse_moves("0 1, 1 1, 2 4 5 6")
    Traceback (most recent call last):
        ...
    ValueError: Each move must have exactly two numbers.
    """
    moves = []
    for pair in input_str.split(","):
        parts = pair.strip().split()

View on GitHub (pinned to f5988cc097)

Solutions

1. Choose a move whose coordinates lie within the matrix dimensions.

When it happens

Trigger: Thrown at matrix/matrix_based_game.py:102 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of TheAlgorithms/Python@f5988cc097 (2026-08-14). Data as JSON: /api/errors/bf3220bdd3f854d4. Report an issue: GitHub.