Skip to content

Commit

Permalink
[no ci] Add empty-columns section to the libcudf developer guide (#17183
Browse files Browse the repository at this point in the history
)

Adds a section on `Empty Columns` to the libcudf DEVELOPER_GUIDE

Authors:
  - David Wendt (https://github.com/davidwendt)

Approvers:
  - Basit Ayantunde (https://github.com/lamarrr)
  - Vukasin Milovanovic (https://github.com/vuule)

URL: #17183
  • Loading branch information
davidwendt authored Oct 30, 2024
1 parent 6328ad6 commit 5ee7d7c
Showing 1 changed file with 11 additions and 0 deletions.
11 changes: 11 additions & 0 deletions cpp/doxygen/developer_guide/DEVELOPER_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -1483,6 +1483,17 @@ struct, and therefore `cudf::struct_view` is the data type of a `cudf::column` o

`cudf::type_dispatcher` dispatches to the `struct_view` data type when invoked on a `STRUCT` column.

# Empty Columns

The libcudf columns support empty, typed content. These columns have no data and no validity mask.
Empty strings or lists columns may or may not contain a child offsets column.
It is undefined behavior (UB) to access the offsets child of an empty strings or lists column.
Nested columns like lists and structs may require other children columns to provide the
nested structure of the empty types.

Use `cudf::make_empty_column()` to create fixed-width and strings columns.
Use `cudf::empty_like()` to create an empty column from an existing `cudf::column_view`.

# cuIO: file reading and writing

cuIO is a component of libcudf that provides GPU-accelerated reading and writing of data file
Expand Down

0 comments on commit 5ee7d7c

Please sign in to comment.