jackc/pgx · error

float4

Error message

float4: %w

What it means

Wrapping error from the binary float4 scan plan: the payload was not exactly 4 bytes, so pgio.Uint32Exact failed. A float4 on the wire is a single uint32 bit pattern; any other length indicates corrupted data.

Solutions

1. Treat as protocol/data corruption — verify the column type and connection integrity
2. Check pgx/server version compatibility

When it happens

Trigger: Thrown at pgtype/float4.go:212 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of jackc/pgx@ec1a0befd2 (2026-08-04). Data as JSON: /api/errors/3138e619e9c16365. Report an issue: GitHub.

Appendix: source

Thrown at pgtype/float4.go:212

			return scanPlanTextAnyToFloat64Scanner{}
		case Int64Scanner:
			return scanPlanTextAnyToInt64Scanner{}
		}
	}

	return nil
}

type scanPlanBinaryFloat4ToFloat32 struct{}

func (scanPlanBinaryFloat4ToFloat32) Scan(src []byte, dst any) error {
	if src == nil {
		return fmt.Errorf("cannot scan NULL into %T", dst)
	}

	raw, err := pgio.Uint32Exact(src)
	if err != nil {
		return fmt.Errorf("float4: %w", err)
	}

	n := int32(raw)
	f := (dst).(*float32)
	*f = math.Float32frombits(uint32(n))

	return nil
}

type scanPlanBinaryFloat4ToFloat64Scanner struct{}

func (scanPlanBinaryFloat4ToFloat64Scanner) Scan(src []byte, dst any) error {
	s := (dst).(Float64Scanner)

	if src == nil {
		return s.ScanFloat64(Float8{})
	}

View on GitHub (pinned to ec1a0befd2)