本教程详细介绍了如何在二维数组中查找给定索引的相邻元素。文章将深入探讨核心查找逻辑，包括如何识别上下左右四个方向的邻居，并重点强调了边界条件检查的重要性，以避免常见的运行时错误。通过提供清晰的java示例代码和详细解释，帮助读者理解并实现一个健壮的相邻元素查找功能。

理解二维数组及其相邻概念

二维数组是数据结构中常用的一种，可以看作是行和列组成的网格。在处理二维数组时，经常需要访问某个元素周围的“邻居”。通常情况下，“邻居”指的是与目标元素在水平或垂直方向上直接相邻的元素，即上、下、左、右四个方向的元素。例如，对于位于 (row, col) 的元素，其邻居通常是 (row-1, col)、(row+1, col)、(row, col-1) 和 (row, col+1)。

核心查找逻辑与边界条件

查找二维数组中某个元素的邻居，关键在于两点：

1. 确定邻居的坐标偏移： 对于 (x, y) 处的元素，其四个方向的邻居坐标分别为 (x-1, y) (上), (x+1, y) (下), (x, y-1) (左), (x, y+1) (右)。
2. 处理边界条件： 这是最重要的一步。如果一个元素位于数组的边缘或角落，那么它可能没有所有四个方向的邻居。例如，第一行的元素没有上方的邻居，第一列的元素没有左方的邻居。在尝试访问这些不存在的邻居时，如果不进行检查，将会导致 ArrayIndexOutOfBoundsException 运行时错误。

因此，在访问任何潜在的邻居之前，必须检查其计算出的坐标是否在数组的有效范围内。

Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载

实现相邻元素查找（Java示例）

以下是一个使用Java实现的函数，用于查找给定二维数组中指定坐标的相邻元素。该函数将返回一个包含所有有效邻居值的列表。

import java.util.ArrayList;
import java.util.List;

public class TwoDArrayNeighbors {

    // 示例二维数组
    public static int[][] createGraph() {
        int[][] myGraph = {
                {1, 2, 3, 4, 5},
                {6, 7, 8, 9, 10},
                {11, 12, 13, 14, 15},
                {16, 17, 18, 19, 20}
        };
        return myGraph;
    }

    /**
     * 查找二维数组中指定坐标的相邻元素。
     * 邻居定义为上下左右四个方向的元素。
     *
     * @param graph 二维数组
     * @param row   目标元素的行索引
     * @param col   目标元素的列索引
     * @return 包含所有有效邻居值的列表
     */
    public static List<Integer> findNeighbors(int[][] graph, int row, int col) {
        List<Integer> neighbors = new ArrayList<>();

        // 定义四个方向的偏移量：上、下、左、右
        int[] dr = {-1, 1, 0, 0}; // 行偏移量
        int[] dc = {0, 0, -1, 1}; // 列偏移量

        // 获取数组的行数和列数
        int numRows = graph.length;
        if (numRows == 0) { // 处理空数组情况
            return neighbors;
        }
        int numCols = graph[0].length;

        // 遍历四个方向
        for (int i = 0; i < 4; i++) {
            int newRow = row + dr[i];
            int newCol = col + dc[i];

            // 检查新坐标是否在数组边界内
            if (newRow >= 0 && newRow < numRows &&
                newCol >= 0 && newCol < numCols) {
                // 如果在边界内，则这是一个有效的邻居
                neighbors.add(graph[newRow][newCol]);
            }
        }
        return neighbors;
    }

    public static void main(String[] args) {
        int[][] myGraph = createGraph();

        // 查找 (2,2) 处的元素 '13' 的邻居
        // 期望结果：8 (上), 18 (下), 12 (左), 14 (右)
        List<Integer> neighborsOf13 = findNeighbors(myGraph, 2, 2);
        System.out.println("元素 '13' (坐标 (2,2)) 的邻居: " + neighborsOf13); // 输出: [8, 18, 12, 14]

        // 查找 (0,0) 处的元素 '1' 的邻居 (角落元素)
        // 期望结果：6 (下), 2 (右)
        List<Integer> neighborsOf1 = findNeighbors(myGraph, 0, 0);
        System.out.println("元素 '1' (坐标 (0,0)) 的邻居: " + neighborsOf1); // 输出: [6, 2]

        // 查找 (0,4) 处的元素 '5' 的邻居 (边缘元素)
        // 期望结果：10 (下), 4 (左)
        List<Integer> neighborsOf5 = findNeighbors(myGraph, 0, 4);
        System.out.println("元素 '5' (坐标 (0,4)) 的邻居: " + neighborsOf5); // 输出: [10, 4]

        // 查找 (3,2) 处的元素 '18' 的邻居 (底部边缘元素)
        // 期望结果：13 (上), 17 (左), 19 (右)
        List<Integer> neighborsOf18 = findNeighbors(myGraph, 3, 2);
        System.out.println("元素 '18' (坐标 (3,2)) 的邻居: " + neighborsOf18); // 输出: [13, 17, 19]
    }
}

代码解析

1. createGraph() 方法： 这是一个辅助方法，用于初始化一个示例的二维整数数组。
2. findNeighbors(int[][] graph, int row, int col) 方法：
   • List neighbors = new ArrayList();：创建一个列表来存储找到的邻居值。
   • int[] dr = {-1, 1, 0, 0}; 和 int[] dc = {0, 0, -1, 1};：这两个数组定义了相对于当前 (row, col) 坐标的四个方向的行和列偏移量。
     • dr[0]=-1, dc[0]=0 -> (row-1, col) (上)
     • dr[1]=1, dc[1]=0 -> (row+1, col) (下)
     • dr[2]=0, dc[2]=-1 -> (row, col-1) (左)
     • dr[3]=0, dc[3]=1 -> (row, col+1) (右)
   • numRows 和 numCols：获取数组的实际维度，这对于边界检查至关重要。
   • for (int i = 0; i
   • int newRow = row + dr[i]; 和 int newCol = col + dc[i];：计算潜在邻居的新坐标。
   • if (newRow >= 0 && newRow = 0 && newCol 核心的边界检查。它确保计算出的 (newRow, newCol) 坐标都在数组的有效索引范围内。
     • newRow >= 0：行索引不能小于0。
     • newRow
     • newCol >= 0：列索引不能小于0。
     • newCol
   • neighbors.add(graph[newRow][newCol]);：如果通过了边界检查，说明这是一个有效邻居，将其值添加到 neighbors 列表中。
3. main() 方法： 演示了如何调用 findNeighbors 方法，并打印出不同位置元素的邻居，包括中心元素、角落元素和边缘元素，以验证功能的正确性。

注意事项与扩展

• 输入验证： 在实际应用中，findNeighbors 方法应该包含对输入 row 和 col 参数的验证，确保它们本身在原始数组的有效范围内，以避免在计算邻居之前就发生错误。
• 对角线邻居： 如果“邻居”的定义需要包含对角线元素（例如，八个方向），则需要扩展 dr 和 dc 数组，增加对角线方向的偏移量，例如 {-1,-1}, {-1,1}, {1,-1}, {1,1}。
• 返回类型： 根据需求，返回类型可以是 List（灵活，适用于数量不定的邻居）、int[]（如果邻居数量固定或已知最大值）、或者自定义一个包含邻居坐标和值的对象列表。
• 性能： 对于大型二维数组，这种直接遍历邻居的方法效率很高，时间复杂度是 O(1)，因为每个元素只有固定数量的邻居。

总结

在二维数组中查找相邻元素是一个常见的操作，其核心在于理解坐标偏移和严格的边界条件检查。通过使用行和列偏移量数组，并结合 if 条件语句来验证新坐标的有效性，可以编写出健壮且高效的 findNeighbors 函数。这不仅能够准确获取所需数据，还能有效避免程序运行时因越界访问而导致的错误。