@@ -63,14 +63,14 @@ class ICEBERG_EXPORT Type : public iceberg::util::Formattable {
6363 [[nodiscard]] virtual bool Equals (const Type& other) const = 0;
6464};
6565
66- // / \brief A data type that may not have child fields.
66+ // / \brief A data type that does not have child fields.
6767class ICEBERG_EXPORT PrimitiveType : public Type {
6868 public:
6969 bool is_primitive () const override { return true ; }
7070 bool is_nested () const override { return false ; }
7171};
7272
73- // / \brief A data type that may have child fields.
73+ // / \brief A data type that has child fields.
7474class ICEBERG_EXPORT NestedType : public Type {
7575 public:
7676 bool is_primitive () const override { return false ; }
@@ -93,7 +93,7 @@ class ICEBERG_EXPORT NestedType : public Type {
9393// / Primitive types do not have nested fields.
9494// / @{
9595
96- // / \brief A data type representing a boolean.
96+ // / \brief A data type representing a boolean (true or false) .
9797class ICEBERG_EXPORT BooleanType : public PrimitiveType {
9898 public:
9999 BooleanType () = default ;
@@ -107,10 +107,10 @@ class ICEBERG_EXPORT BooleanType : public PrimitiveType {
107107};
108108
109109// / \brief A data type representing a 32-bit signed integer.
110- class ICEBERG_EXPORT Int32Type : public PrimitiveType {
110+ class ICEBERG_EXPORT IntType : public PrimitiveType {
111111 public:
112- Int32Type () = default ;
113- ~Int32Type () = default ;
112+ IntType () = default ;
113+ ~IntType () = default ;
114114
115115 TypeId type_id () const override ;
116116 std::string ToString () const override ;
@@ -120,10 +120,10 @@ class ICEBERG_EXPORT Int32Type : public PrimitiveType {
120120};
121121
122122// / \brief A data type representing a 64-bit signed integer.
123- class ICEBERG_EXPORT Int64Type : public PrimitiveType {
123+ class ICEBERG_EXPORT LongType : public PrimitiveType {
124124 public:
125- Int64Type () = default ;
126- ~Int64Type () = default ;
125+ LongType () = default ;
126+ ~LongType () = default ;
127127
128128 TypeId type_id () const override ;
129129 std::string ToString () const override ;
@@ -132,11 +132,12 @@ class ICEBERG_EXPORT Int64Type : public PrimitiveType {
132132 bool Equals (const Type& other) const override ;
133133};
134134
135- // / \brief A data type representing a 32-bit (single precision) float.
136- class ICEBERG_EXPORT Float32Type : public PrimitiveType {
135+ // / \brief A data type representing a 32-bit (single precision) IEEE-754
136+ // / float.
137+ class ICEBERG_EXPORT FloatType : public PrimitiveType {
137138 public:
138- Float32Type () = default ;
139- ~Float32Type () = default ;
139+ FloatType () = default ;
140+ ~FloatType () = default ;
140141
141142 TypeId type_id () const override ;
142143 std::string ToString () const override ;
@@ -145,11 +146,12 @@ class ICEBERG_EXPORT Float32Type : public PrimitiveType {
145146 bool Equals (const Type& other) const override ;
146147};
147148
148- // / \brief A data type representing a 64-bit (double precision) float.
149- class ICEBERG_EXPORT Float64Type : public PrimitiveType {
149+ // / \brief A data type representing a 64-bit (double precision) IEEE-754
150+ // / float.
151+ class ICEBERG_EXPORT DoubleType : public PrimitiveType {
150152 public:
151- Float64Type () = default ;
152- ~Float64Type () = default ;
153+ DoubleType () = default ;
154+ ~DoubleType () = default ;
153155
154156 TypeId type_id () const override ;
155157 std::string ToString () const override ;
@@ -240,7 +242,7 @@ class ICEBERG_EXPORT TimestampType : public TimestampBase {
240242};
241243
242244// / \brief A data type representing a timestamp as microseconds since the
243- // / epoch in UTC.
245+ // / epoch in UTC. A time zone or offset is not stored.
244246class ICEBERG_EXPORT TimestampTzType : public TimestampBase {
245247 public:
246248 TimestampTzType () = default ;
@@ -256,7 +258,7 @@ class ICEBERG_EXPORT TimestampTzType : public TimestampBase {
256258 bool Equals (const Type& other) const override ;
257259};
258260
259- // / \brief A data type representing a bytestring .
261+ // / \brief A data type representing an arbitrary-length byte sequence .
260262class ICEBERG_EXPORT BinaryType : public PrimitiveType {
261263 public:
262264 BinaryType () = default ;
@@ -269,7 +271,8 @@ class ICEBERG_EXPORT BinaryType : public PrimitiveType {
269271 bool Equals (const Type& other) const override ;
270272};
271273
272- // / \brief A data type representing a string.
274+ // / \brief A data type representing an arbitrary-length character sequence
275+ // / (encoded in UTF-8).
273276class ICEBERG_EXPORT StringType : public PrimitiveType {
274277 public:
275278 StringType () = default ;
0 commit comments