docs: add IntegerValue invariant doc comment in format_string.rs

kosiew · kosiew · commit 08209643134b · 2026-05-20T17:16:52.000+08:00
diff --git a/datafusion/spark/src/function/string/format_string.rs b/datafusion/spark/src/function/string/format_string.rs
@@ -891,6 +891,9 @@ fn unsigned_to_char(value: u64) -> Result<char> {
     codepoint_to_char(codepoint)
 }
 
+/// Normalizes integer scalar payloads while preserving Spark formatting semantics:
+/// signed values format as decimal for `%d` / `%s` / `%c`, but use their original
+/// bit width for `%x` / `%o` via `unsigned_bits`.
 #[derive(Debug, Clone, Copy)]
 enum IntegerValue {
     Signed { decimal: i64, unsigned_bits: u64 },

Original file line number	Diff line number	Diff line change
`@@ -891,6 +891,9 @@ fn unsigned_to_char(value: u64) -> Result<char> {`
`891`	`891`	`codepoint_to_char(codepoint)`
`892`	`892`	`}`
`893`	`893`
	`894`	`+/// Normalizes integer scalar payloads while preserving Spark formatting semantics:`
	`895`	+/// signed values format as decimal for `%d` / `%s` / `%c`, but use their original
	`896`	+/// bit width for `%x` / `%o` via `unsigned_bits`.
`894`	`897`	`#[derive(Debug, Clone, Copy)]`
`895`	`898`	`enum IntegerValue {`
`896`	`899`	`Signed { decimal: i64, unsigned_bits: u64 },`