#[repr(Rust)] layout

[yhx-12243]

#[repr(Rust)] layout

[ralfbiedert]

The std docs for Vec say:

Most fundamentally, Vec is and always will be a (pointer, capacity, length) triplet. No more, no less. The order of these fields is completely unspecified [...]

However, they also give this specific example (pointer, capacity, length) for illustrative purposes; and I think we are no different in that respect.

That said, I can understand that the disclaimer we have is 1-2 pages away and it might be misleading for some people that jump into that section without reading the context; maybe repeating that hint might be warranted.

[ralfbiedert]

Maybe I misunderstand, but we already have a disclaimer that you are not allowed to transmute unless you have representation guarantees which I think Vec doesn't give, neither for it being repr(C), nor for these fields to be in a particular order if it were.

So from that perspective all depictions are merely illustrative anyways, and the point is to depict what's contained, not where exactly that resides.

[yhx-12243]

What I means is that in Memory Layout > Standard Library Types chapter, the Vec<T> is drawn with a specific order. Is this appropriate (need not change) or to be changed?

Or maybe adding some comments will be better?