Method SerializeTo

go/fory/fory.go:594–639

SerializeTo serializes a value and appends the bytes to the provided buffer. This is useful when you need to write multiple serialized values to the same buffer. Returns error if serialization fails.

(buf *ByteBuffer, value any)

// This is useful when you need to write multiple serialized values to the same buffer.
// Returns error if serialization fails.
func (f *Fory) SerializeTo(buf *ByteBuffer, value any) error {
	defer f.resetWriteState()

	// Temporarily swap buffer
	origBuffer := f.writeCtx.buffer
	f.writeCtx.buffer = buf

	// Write protocol header
	writeHeader(f.writeCtx, f.config)

	// Fast path for pointer-to-struct types (bypasses ptrToValueSerializer wrapper)
	rv := reflect.ValueOf(value)
	if rv.Kind() == reflect.Ptr && !rv.IsNil() && rv.Elem().Kind() == reflect.Struct && !f.config.TrackRef {
		// Get TypeInfo using fast pointer cache
		elemValue := rv.Elem()
		typeInfo, err := f.typeResolver.getTypeInfo(rv, true)
		if err == nil && typeInfo != nil && typeInfo.Serializer != nil {
			// Write not-null flag and type ID directly
			buf.WriteInt8(NotNullValueFlag)
			f.typeResolver.WriteTypeInfo(buf, typeInfo, f.writeCtx.Err())
			// Call the underlying struct serializer's WriteData directly
			if ptrSer, ok := typeInfo.Serializer.(*ptrToValueSerializer); ok {
				ptrSer.valueSerializer.WriteData(f.writeCtx, elemValue)
			} else {
				typeInfo.Serializer.WriteData(f.writeCtx, elemValue)
			}
			if f.writeCtx.HasError() {
				f.writeCtx.buffer = origBuffer
				return f.writeCtx.TakeError()
			}
			f.writeCtx.buffer = origBuffer
			return nil
		}
	}

	// Standard path - TypeMeta is written inline using streaming protocol
	f.writeCtx.WriteValue(rv, RefModeTracking, true)
	if f.writeCtx.HasError() {
		f.writeCtx.buffer = origBuffer
		return f.writeCtx.TakeError()
	}

	// Restore original buffer
	f.writeCtx.buffer = origBuffer
	return nil
}

// DeserializeFrom deserializes data from an existing buffer directly into the provided target value.
// The buffer's reader index is advanced as data is read.