encoder/decoder release API

README.md

@@ -82,6 +82,14 @@ err := jzon.Unmarshal(b, &data)
 
 // Marshal
 b, err := jzon.Marshal(&data)
+
+// Decoder
+dec := jzon.NewDecoder(reader)
+defer dec.Release()
+
+// Encoder
+enc := jzon.NewEncoder(writer)
+defer enc.Release()
 ```
 
 ### Iterator

decoder.go

@@ -10,6 +10,11 @@ type Decoder struct {
 	err error
 }
 
+func (dec *Decoder) Release() {
+	dec.it.Release()
+	dec.it = nil
+}
+
 func (dec *Decoder) UseNumber() {
 	dec.it.useNumber = true
 }

decoder_config.go

@@ -105,11 +105,6 @@ func (decCfg *DecoderConfig) NewDecoder(r io.Reader) *Decoder {
 	}
 }
 
-func (decCfg *DecoderConfig) ReturnDecoder(dec *Decoder) {
-	dec.it.Release()
-	dec.it = nil
-}
-
 // the typ must be a pointer type
 func (decCfg *DecoderConfig) createDecoder(rType rtype, ptrType reflect.Type) ValDecoder {
 	decCfg.cacheMu.Lock()

decoder_test.go

@@ -93,7 +93,9 @@ func TestDecoder(t *testing.T) {
 				check(dec, 1, false, 6, 7)
 			}
 			f(json.NewDecoder(newReader()))
-			f(NewDecoder(newReader()))
+			dec := NewDecoder(newReader())
+			defer dec.Release()
+			f(dec)
 		})
 		t.Run("failure at start", func(t *testing.T) {
 			must := require.New(t)
@@ -114,7 +116,9 @@ func TestDecoder(t *testing.T) {
 				must.Equal(err2, err)
 			}
 			f(json.NewDecoder(newReader()))
-			f(NewDecoder(newReader()))
+			dec := NewDecoder(newReader())
+			defer dec.Release()
+			f(dec)
 		})
 		t.Run("failure at middle", func(t *testing.T) {
 			must := require.New(t)
@@ -134,7 +138,9 @@ func TestDecoder(t *testing.T) {
 				must.Error(err2)
 			}
 			f(json.NewDecoder(newReader()))
-			f(NewDecoder(newReader()))
+			dec := NewDecoder(newReader())
+			defer dec.Release()
+			f(dec)
 		})
 	})
 }
@@ -153,7 +159,9 @@ func TestDecoder_UseNumber(t *testing.T) {
 		must.Equal(json.Number(s), i)
 	}
 	f(json.NewDecoder(newReader()))
-	f(NewDecoder(newReader()))
+	dec := NewDecoder(newReader())
+	defer dec.Release()
+	f(dec)
 }
 
 func TestDecoder_DisallowUnknownFields(t *testing.T) {
@@ -170,5 +178,7 @@ func TestDecoder_DisallowUnknownFields(t *testing.T) {
 		must.Error(err)
 	}
 	f(json.NewDecoder(newReader()))
-	f(NewDecoder(newReader()))
+	dec := NewDecoder(newReader())
+	defer dec.Release()
+	f(dec)
 }

encoder.go

@@ -5,6 +5,11 @@ type Encoder struct {
 	err error
 }
 
+func (e *Encoder) Release() {
+	e.s.Release()
+	e.s = nil
+}
+
 func encodeInternal(s *Streamer, v interface{}) error {
 	if err := s.Value(v).Flush(); err != nil {
 		return err

encoder_config.go

@@ -102,11 +102,6 @@ func (encCfg *EncoderConfig) NewEncoder(w io.Writer) *Encoder {
 	}
 }
 
-func (encCfg *EncoderConfig) ReturnEncoder(enc *Encoder) {
-	enc.s.Release()
-	enc.s = nil
-}
-
 func (encCfg *EncoderConfig) getEncoderFromCache(rtype rtype) ValEncoder {
 	return encCfg.encoderCache.Load().(encoderCache)[rtype]
 }

encoder_test.go

@@ -39,7 +39,9 @@ func TestEncoder_SetEscapeHTML(t *testing.T) {
 		must.Equal(`"`+s+`"`+"\n", buf.String(), "%T", enc)
 	}
 	f(json.NewEncoder(buf))
-	f(NewEncoder(buf))
+	enc := NewEncoder(buf)
+	defer enc.Release()
+	f(enc)
 }
 
 // func TestEncoder_SetIndent(t *testing.T) {

standard_compatible.go

@@ -27,14 +27,6 @@ func NewDecoder(r io.Reader) *Decoder {
 	return DefaultDecoderConfig.NewDecoder(r)
 }
 
-func ReturnDecoder(dec *Decoder) {
-	DefaultDecoderConfig.ReturnDecoder(dec)
-}
-
 func NewEncoder(w io.Writer) *Encoder {
 	return DefaultEncoderConfig.NewEncoder(w)
 }
-
-func ReturnEncoder(enc *Encoder) {
-	DefaultEncoderConfig.ReturnEncoder(enc)
-}