alamb opened a new pull request, #40512:
URL: https://github.com/apache/arrow/pull/40512

   
   
   ### Rationale for this change
   While  implementing `Variable-size Binary View Layout` (thanks @ariesdevil 
!) in  https://github.com/apache/arrow-rs/pull/5481 it was not 100% clear if 
the inlined string was zero padded. 
   
   @bkietz noted that 
   
   > The spec does say "padded with zero" 
https://github.com/apache/arrow/blob/main/docs/source/format/Columnar.rst?plain=1#L384
 but it could be repeated in the surrounding paragraph. In any case, padded 
with zero is definitely the intent
   
   ```
       * Short strings, length <= 12
         | Bytes 0-3  | Bytes 4-15                            |
         |------------|---------------------------------------|
         | length     | data (padded with 0)                  |
   ```
   ### What changes are included in this PR?
   
   Add a sentence in the surrounding text to make it clear the inlined strings 
values are zero padded
   
   Note I do not think this is a specification change (and therefore doesn't 
need a vote on the mailing list) as the spec already specifies the padding is 
zero (in the diagram). This simply clarifies the text to emphasize this point 
for ease of understanding
   
   ### Are these changes tested?
   
   <!--
   We typically require tests for all PRs in order to:
   1. Prevent the code from being accidentally broken by subsequent changes
   2. Serve as another way to document the expected behavior of the code
   
   If tests are not included in your PR, please explain why (for example, are 
they covered by existing tests)?
   -->
   
   ### Are there any user-facing changes?
   
   <!--
   If there are user-facing changes then we may require documentation to be 
updated before approving the PR.
   -->
   
   <!--
   If there are any breaking changes to public APIs, please uncomment the line 
below and explain which changes are breaking.
   -->
   <!-- **This PR includes breaking changes to public APIs.** -->
   
   <!--
   Please uncomment the line below (and provide explanation) if the changes fix 
either (a) a security vulnerability, (b) a bug that caused incorrect or invalid 
data to be produced, or (c) a bug that causes a crash (even when the API 
contract is upheld). We use this to highlight fixes to issues that may affect 
users without their knowledge. For this reason, fixing bugs that cause errors 
don't count, since those are usually obvious.
   -->
   <!-- **This PR contains a "Critical Fix".** -->


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to