@@ -26,10 +26,7 @@ namespace CUDF_EXPORT cudf {
2626 * @brief Construct a dictionary column by copying the provided `keys`
2727 * and `indices`.
2828 *
29- * It is expected that `keys_column.has_nulls() == false`.
30- * It is assumed the elements in `keys_column` are unique and
31- * are in a strict, total order. Meaning, `keys_column[i]` is ordered before
32- * `keys_column[i+1]` for all `i in [0,n-1)` where `n` is the number of keys.
29+ * The keys_column must contain no nulls.
3330 *
3431 * The indices values must be in the range [0,keys_column.size()).
3532 *
@@ -49,7 +46,7 @@ namespace CUDF_EXPORT cudf {
4946 * @throw std::invalid_argument if keys_column contains nulls
5047 * @throw std::invalid_argument if indices_column type is not a signed integer
5148 *
52- * @param keys_column Column of unique, ordered values to use as the new dictionary column's keys.
49+ * @param keys_column Column of non-null values to use as the new dictionary column's keys.
5350 * @param indices_column Indices to use for the new dictionary column.
5451 * @param stream CUDA stream used for device memory operations and kernel launches.
5552 * @param mr Device memory resource used to allocate the returned column's device memory.
@@ -66,16 +63,12 @@ std::unique_ptr<column> make_dictionary_column(
6663 * and indices columns.
6764 *
6865 * The keys_column and indices columns must contain no nulls.
69- * It is assumed the elements in `keys_column` are unique and
70- * are in a strict, total order. Meaning, `keys_column[i]` is ordered before
71- * `keys_column[i+1]` for all `i in [0,n-1)` where `n` is the number of keys.
72- *
7366 * The indices values must be in the range [0,keys_column.size()).
7467 *
7568 * @throw std::invalid_argument if keys_column or indices_column contains nulls
7669 * @throw std::invalid_argument if indices_column type is not a signed integer type
7770 *
78- * @param keys_column Column of unique, ordered values to use as the new dictionary column's keys.
71+ * @param keys_column Column of non-null values to use as the new dictionary column's keys.
7972 * @param indices_column Indices to use for the new dictionary column.
8073 * @param null_mask Null mask for the output column.
8174 * @param null_count Number of nulls for the output column.
@@ -101,7 +94,7 @@ std::unique_ptr<column> make_dictionary_column(std::unique_ptr<column> keys_colu
10194 *
10295 * @throw cudf::logic_error if keys_column contains nulls
10396 *
104- * @param keys_column Column of unique, ordered values to use as the new dictionary column's keys.
97+ * @param keys_column Column of non-null values to use as the new dictionary column's keys.
10598 * @param indices_column Indices values and null-mask to use for the new dictionary column.
10699 * @param stream CUDA stream used for device memory operations and kernel launches.
107100 * @param mr Device memory resource used to allocate the returned column's device memory.
0 commit comments