Índice de array por linhas: offset e endereço

Esta calculadora transforma coordenadas de um array multidimensional na posição linear única usada pelo armazenamento contíguo por linhas no estilo C. Informe as dimensões do eixo mais externo ao mais interno, um índice de base zero para cada eixo, o tamanho do elemento em bytes e, se desejar, o endereço-base. O resultado apresenta o stride de cada eixo, a contribuição de cada índice, o offset do elemento, o offset em bytes e o endereço final, facilitando a conferência de ponteiros e buffers achatados.

Informe dimensões e índices na mesma ordem de eixos

Liste os tamanhos das dimensões do eixo mais externo ao mais interno, exatamente como aparecem na declaração ou no shape. Em um array com 3 planos, 4 linhas e 5 colunas, informe 3, 4 e 5. Depois, forneça um índice de base zero por dimensão, na mesma ordem.

A coordenada do segundo plano, da terceira linha e da quarta coluna é 1, 2 e 3. Cada dimensão precisa ser um inteiro positivo; cada índice deve ser igual ou maior que zero e menor que a dimensão correspondente. A calculadora rejeita ranks incompatíveis e coordenadas fora dos limites, evitando produzir silenciosamente um endereço externo ao array.

O tamanho do elemento também é obrigatório, pois o índice sozinho não define um local em bytes. Use a largura real, como quatro bytes para um inteiro comum de 32 bits ou oito para um double. Se você souber onde o array começa, informe o endereço-base não negativo; caso contrário, mantenha zero e interprete o resultado como offset desde o início.

Entenda o cálculo de stride por linhas

Na ordem por linhas, o último eixo fica contíguo; avançar uma posição nesse eixo desloca exatamente um elemento, portanto seu stride é um. O stride de cada eixo anterior é o produto de todas as dimensões à direita. Para dimensões 3 por 4 por 5, os strides são 20, 5 e 1: mudar de plano pula quatro linhas com cinco elementos, mudar de linha pula cinco elementos e mudar de coluna pula um.

A ferramenta multiplica cada índice pelo stride de seu eixo e exibe esses produtos como contribuições. A soma gera o índice linear de base zero. Para 1, 2 e 3, a conta é 1 vezes 20, mais 2 vezes 5, mais 3 vezes 1, totalizando 33.

Os valores intermediários tornam o resultado auditável e revelam erros comuns, como inverter dimensões ou usar multiplicadores de ordem por colunas. Toda operação usa inteiros verificados. Se um produto ou uma soma ultrapassar o intervalo seguro do JavaScript, a entrada é rejeitada em vez de retornar um endereço arredondado.

Converta o índice do elemento em endereço de bytes

O índice linear conta elementos, não bytes. Para obter o offset em bytes, multiplique esse índice pelo tamanho do elemento. O elemento 33, com elementos de oito bytes, começa 264 bytes após o início do array.

O endereço final é esse offset somado ao endereço-base: com base 4096, o elemento começa em 4360. A resposta separa índice linear, offset em bytes, endereço-base e endereço final para que você compare cada etapa com código-fonte, depurador, especificação binária ou cálculo de buffer de GPU. O endereço é um inteiro decimal exato dentro do intervalo seguro; a ferramenta não acessa memória nem examina processos.

O cálculo pressupõe um array denso e contíguo, sem padding entre elementos ou linhas. Linhas com pitch, dimensões principais explícitas, views fatiadas ou strides personalizados exigem os strides físicos reais.