Skip to content

Commit 6b4c524

Browse files
authored
GH-50172: [Doc][Format] Clarify that variadic buffers can also be null (#50255)
### Rationale for this change Some implementations are known to produce null variadic buffers in BinaryView arrays, and expose them on the C Data Interface. Since Arrow C++, and perhaps other implementations, make the wrong assumption that imported variadic buffers cannot be null, clarify the docs. ### Are these changes tested? N/A. ### Are there any user-facing changes? No. * GitHub Issue: #50172 Authored-by: Antoine Pitrou <antoine@python.org> Signed-off-by: Antoine Pitrou <antoine@python.org>
1 parent 388e95b commit 6b4c524

1 file changed

Lines changed: 2 additions & 1 deletion

File tree

docs/source/format/CDataInterface.rst

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -491,7 +491,8 @@ It has the following fields:
491491
The buffer pointers MAY be null only in two situations:
492492

493493
1. for the null bitmap buffer, if :c:member:`ArrowArray.null_count` is 0;
494-
2. for any buffer, if the size in bytes of the corresponding buffer would be 0.
494+
2. for any buffer (including variadic buffers), if the size in bytes of the
495+
corresponding buffer would be 0.
495496

496497
Buffers of children arrays are not included.
497498

0 commit comments

Comments
 (0)