[foreign-memaccess+abi] RFR: 8291639: Improve the ability to visualize a MemorySegment in human readable forms [v2]

[Rémi Forax]

On Fri, 26 May 2023 13:01:57 GMT, Per Minborg <pminborg at openjdk.org> wrote:

>> This PR proposes to add a "Record Mapper" that allows `MemorySegment` instances to be projected onto `Record` types given `GroupLayout` instances.
>> 
>> Here is a simple example of how to use the mapper:
>> 
>> 
>>     private static final GroupLayout POINT_LAYOUT = MemoryLayout.structLayout(
>>             JAVA_INT.withName("x"),
>>             JAVA_INT.withName("y"));
>> 
>>     MemorySegment segment =  MemorySegment.ofArray(new int[]{3, 4});
>> 
>>     Point point = POINT_LAYOUT.recordMapper(Point.class)
>>           .apply(segment); // Point[x=3, y=4]
>> 
>> 
>> I think the implementation can be improved later, for example by de-duplicating handling of arrays and maybe add recursive "un-pealing" of multidimensional arrays.
>
> Per Minborg has updated the pull request with a new target base due to a merge or a rebase. The pull request now contains 29 commits:
> 
>  - Merge master
>  - Fix typos
>  - Clean up toString methods
>  - Add support for MemoryAddress arrays and improve docs
>  - Improve javadoc
>  - Change to IAE if mapper fails
>  - Remove caching
>  - Add tests for initial issue examples
>  - Clean up and optimize
>  - Add support for multidimensional records
>  - ... and 19 more: https://git.openjdk.org/panama-foreign/compare/bee4503b...1d7db589

src/java.base/share/classes/java/lang/foreign/GroupLayout.java line 209:

> 207:      * @since 21
> 208:      */
> 209:     <R extends Record> Function<MemorySegment, R> recordMapper(Class<R> type);

you also need to throw an IAE if type is Record.class, java.lang.Record is the only subtype of java.lang.Record which is not a record

-------------

PR Review Comment: https://git.openjdk.org/panama-foreign/pull/833#discussion_r1206748447