Exported Unescape for users who want to unescape their search keys

Author: daboyuka

escape.go

@@ -106,7 +106,7 @@ func unescapeToUTF8(in, out []byte) (inLen int, outLen int) {
 //   'out' is used to build the unescaped string and is returned with no extra allocation
 // Else:
 //   A new slice is allocated and returned.
-func unescape(in, out []byte) ([]byte, error) {
+func Unescape(in, out []byte) ([]byte, error) {
 	firstBackslash := bytes.IndexByte(in, '\\')
 	if firstBackslash == -1 {
 		return in, nil

escape_test.go

@@ -168,7 +168,7 @@ func TestUnescape(t *testing.T) {
 			in := []byte(test.in)
 			buf := buftest.buf
 
-			out, err := unescape(in, buf)
+			out, err := Unescape(in, buf)
 			isErr := (err != nil)
 			isAlloc := !isSameMemory(out, in) && !isSameMemory(out, buf)
 

parser.go

@@ -144,7 +144,7 @@ func searchKeys(data []byte, keys ...string) int {
 
 				// for unescape: if there are no escape sequences, this is cheap; if there are, it is a
 				// bit more expensive, but causes no allocations unless len(key) > unescapeStackBufSize
-				if keyUnesc, err := unescape(key, stackbuf[:]); err != nil {
+				if keyUnesc, err := Unescape(key, stackbuf[:]); err != nil {
 					return -1
 				} else {
 					keyUnescStr := unsafeBytesToString(keyUnesc)
@@ -407,7 +407,7 @@ func GetString(data []byte, keys ...string) (val string, err error) {
 	}
 
 	var stackbuf [unescapeStackBufSize]byte // stack-allocated array for allocation-free unescaping of small strings
-	out, err := unescape(v, stackbuf[:])
+	out, err := Unescape(v, stackbuf[:])
 
 	return string(out), err
 }