archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-26 14:24:46 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8334107: Specification for MemorySegment::get/setString could use some clarification

Browse source 
Reviewed-by: jvernee
This commit is contained in:
Per Minborg 2024-11-07 07:25:41 +00:00
parent a6c85daa1c
commit 619b4d5966
1 changed files with 5 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

7
src/java.base/share/classes/java/lang/foreign/MemorySegment.java
View file

@ -1307,7 +1307,8 @@ public sealed interface MemorySegment permits AbstractMemorySegmentImpl {
* @param offset offset in bytes (relative to this segment address) at which this * @param offset offset in bytes (relative to this segment address) at which this
* access operation will occur * access operation will occur
* @param charset the charset used to {@linkplain Charset#newDecoder() decode} the * @param charset the charset used to {@linkplain Charset#newDecoder() decode} the
* string bytes * string bytes. The {@code charset} must be a
* {@linkplain StandardCharsets standard charset}
* @return a Java string constructed from the bytes read from the given starting * @return a Java string constructed from the bytes read from the given starting
* address up to (but not including) the first {@code '\0'} terminator * address up to (but not including) the first {@code '\0'} terminator
* character (assuming one is found) * character (assuming one is found)
@ -1375,7 +1376,9 @@ public sealed interface MemorySegment permits AbstractMemorySegmentImpl {
* access operation will occur, the final address of this write * access operation will occur, the final address of this write
* operation can be expressed as {@code address() + offset} * operation can be expressed as {@code address() + offset}
* @param str the Java string to be written into this segment * @param str the Java string to be written into this segment
* @param charset the charset used to {@linkplain Charset#newEncoder() encode} the string bytes * @param charset the charset used to {@linkplain Charset#newEncoder() encode} the
* string bytes. The {@code charset} must be a
* {@linkplain StandardCharsets standard charset}
* @throws IndexOutOfBoundsException if {@code offset < 0} * @throws IndexOutOfBoundsException if {@code offset < 0}
* @throws IndexOutOfBoundsException if {@code offset > byteSize() - (B + N)}, where: * @throws IndexOutOfBoundsException if {@code offset > byteSize() - (B + N)}, where:
* <ul> * <ul>