[Doc Improvement] Not obvious how to define Array of Arrays

[lukasjuhrich]

Operating System

Linux

What's the issue you encountered?

Conceptually, I'm having a pattern like this:

import std.array;
struct File {
    u8 dim1, dim2;
    std::Array<std::Array<u8, dim1>, dim2> cells;
};

File file @ 0x00;

this results in No variable named 'dim1' found.

How can the issue be reproduced?

Create a file with the contents

const uint8_t data[6] = {
    0x02, 0x02, 0x00, 0x00, 0x00, 0x00, 
};

and use the pattern above.

Error vanishes when replacing the inner dim1 by 2 .

ImHex Version

1.35.3

ImHex Build Type

• Nightly or built from sources

Installation type

Arch package

Additional context?

Version: 1.35.3
Commit: v1.35.X@dffb7e9
Build time: Jun 29 2024, 19:35:52
Type: Installed

[paxcut]

I don't think that's a bug. The inner Array doesn't have direct access to the variables of the File struct. You can use the parent keyword to access the variables of the parent. The following code works in the example you wrote:

import std.array;
struct File {
    u8 dim1, dim2;
    std::Array<std::Array<u8, parent.dim1>, dim2> cells;
};

File file @ 0x00;

[lukasjuhrich]

You can use the parent keyword to access the variables of the parent.

I've been looking for something like that, thanks!
So let's consider this a documentation bug – a line like this would be very helpful in the documentation of std::array. These docs claim that Array<T, Size> can be used to build multi-dimensional arrays, but does not provide an example for how to achieve that.

[paxcut]

Would you consider perhaps a change in the title? That would help users seeking answers.

[lukasjuhrich]

Would you consider perhaps a change in the title?

Sure, hope this is better.