tree.go - external/github.com/julienschmidt/httprouter - Git at Google

 // Copyright 2013 Julien Schmidt. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be found
 // in the LICENSE file.

 package httprouter

 import (
 	"strings"
 )

 func min(a, b int) int {
 	if a <= b {
 		return a
 	}
 	return b
 }

 func countParams(path string) uint8 {
 	var n uint
 	for i := 0; i < len(path); i++ {
 		if path[i] != ':' && path[i] != '*' {
 			continue
 		}
 		n++
 	}
 	if n >= 255 {
 		return 255
 	}
 	return uint8(n)
 }

 func toLower(b byte) byte {
 	if 'A' <= b && b <= 'Z' {
 		b += 'a' - 'A'
 	}
 	return b
 }

 type nodeType uint8

 const (
 	static nodeType = iota // default
 	root
 	param
 	catchAll
 )

 type node struct {
 	pfx       string // first len(children) byte are indices, other are prefix
 	wildChild bool
 	nType     nodeType
 	maxParams uint8
 	children  []*node
 	handle    Handle
 	priority  uint32
 }

 // increments priority of the given child and reorders if necessary
 func (n *node) incrementChildPrio(pos int) int {
 	n.children[pos].priority++
 	prio := n.children[pos].priority

 	// adjust position (move to front)
 	newPos := pos
 	for newPos > 0 && n.children[newPos-1].priority < prio {
 		// swap node positions
 		tmpN := n.children[newPos-1]
 		n.children[newPos-1] = n.children[newPos]
 		n.children[newPos] = tmpN

 		newPos--
 	}

 	// build new index char string
 	if newPos != pos {
 		n.pfx = n.pfx[:newPos] + // unchanged prefix, might be empty
 			n.pfx[pos:pos+1] + // the index char we move
 			n.pfx[newPos:pos] + n.pfx[pos+1:] // rest without char at 'pos'
 	}

 	return newPos
 }

 // addRoute adds a node with the given handle to the path.
 // Not concurrency-safe!
 func (n *node) addRoute(path string, handle Handle) {
 	fullPath := path
 	n.priority++
 	numParams := countParams(path)

 	// non-empty tree
 	if len(n.pfx) > 0 {
 		prefix := n.pfx[len(n.children):]
 	walk:
 		for {
 			// Update maxParams of the current node
 			if numParams > n.maxParams {
 				n.maxParams = numParams
 			}

 			// Find the longest common prefix.
 			// This also implies that the common prefix contains no ':' or '*'
 			// since the existing key can't contain those chars.
 			i := 0
 			max := min(len(path), len(prefix))
 			for i < max && path[i] == prefix[i] {
 				i++
 			}

 			// Split edge
 			if i < len(prefix) {
 				child := node{
 					pfx:       n.pfx[:len(n.children)] + prefix[i:],
 					wildChild: n.wildChild,
 					children:  n.children,
 					handle:    n.handle,
 					priority:  n.priority - 1,
 				}

 				// Update maxParams (max of all children)
 				for i := range child.children {
 					if child.children[i].maxParams > child.maxParams {
 						child.maxParams = child.children[i].maxParams
 					}
 				}

 				n.children = []*node{&child}
 				// []byte for proper unicode char conversion, see #65
 				n.pfx = string([]byte{prefix[i]}) + path[:i]
 				n.handle = nil
 				n.wildChild = false
 			}

 			// Make new node a child of this node
 			if i < len(path) {
 				path = path[i:]

 				if n.wildChild {
 					n = n.children[0]
 					n.priority++
 					prefix = n.pfx[len(n.children):]

 					// Update maxParams of the child node
 					if numParams > n.maxParams {
 						n.maxParams = numParams
 					}
 					numParams--

 					// Check if the wildcard matches
 					if len(path) >= len(prefix) && prefix == path[:len(prefix)] {
 						// check for longer wildcard, e.g. :name and :names
 						if len(prefix) >= len(path) || path[len(prefix)] == '/' {
 							continue walk
 						}
 					}

 					panic("path segment '" + path +
 						"' conflicts with existing wildcard '" + prefix +
 						"' in path '" + fullPath + "'")
 				}

 				c := path[0]

 				// slash after param
 				if n.nType == param && c == '/' && len(n.children) == 1 {
 					n = n.children[0]
 					n.priority++
 					prefix = n.pfx[len(n.children):]
 					continue walk
 				}

 				// Check if a child with the next path byte exists
 				for i := 0; i < len(n.children); i++ {
 					if c == n.pfx[i] {
 						i = n.incrementChildPrio(i)
 						n = n.children[i]
 						prefix = n.pfx[len(n.children):]
 						continue walk
 					}
 				}

 				// Otherwise insert it
 				if c != ':' && c != '*' {
 					// []byte for proper unicode char conversion, see #65
 					n.pfx = n.pfx[:len(n.children)] + string([]byte{c}) + n.pfx[len(n.children):]
 					child := &node{
 						maxParams: numParams,
 					}
 					n.children = append(n.children, child)
 					n.incrementChildPrio(len(n.children) - 1)
 					n = child
 				}
 				n.insertChild(numParams, path, fullPath, handle)
 				return

 			} else if i == len(path) { // Make node a (in-path) leaf
 				if n.handle != nil {
 					panic("a handle is already registered for path ''" + fullPath + "'")
 				}
 				n.handle = handle
 			}
 			return
 		}
 	} else { // Empty tree
 		n.insertChild(numParams, path, fullPath, handle)
 		n.nType = root
 	}
 }

 func (n *node) insertChild(numParams uint8, path, fullPath string, handle Handle) {
 	var offset int // already handled bytes of the path

 	// find prefix until first wildcard (beginning with ':'' or '*'')
 	for i, max := 0, len(path); numParams > 0; i++ {
 		c := path[i]
 		if c != ':' && c != '*' {
 			continue
 		}

 		// find wildcard end (either '/' or path end)
 		end := i + 1
 		for end < max && path[end] != '/' {
 			switch path[end] {
 			// the wildcard name must not contain ':' and '*'
 			case ':', '*':
 				panic("only one wildcard per path segment is allowed, has: '" +
 					path[i:] + "' in path '" + fullPath + "'")
 			default:
 				end++
 			}
 		}

 		// check if this Node existing children which would be
 		// unreachable if we insert the wildcard here
 		if len(n.children) > 0 {
 			panic("wildcard route '" + path[i:end] +
 				"' conflicts with existing children in path '" + fullPath + "'")
 		}

 		// check if the wildcard has a name
 		if end-i < 2 {
 			panic("wildcards must be named with a non-empty name in path '" + fullPath + "'")
 		}

 		if c == ':' { // param
 			// split path at the beginning of the wildcard
 			if i > 0 {
 				n.pfx = ":" + path[offset:i]
 				offset = i
 			} else {
 				n.pfx = ":" + n.pfx
 			}

 			child := &node{
 				nType:     param,
 				maxParams: numParams,
 			}
 			n.children = []*node{child}
 			n.wildChild = true
 			n = child
 			n.priority++
 			numParams--

 			// if the path doesn't end with the wildcard, then there
 			// will be another non-wildcard subpath starting with '/'
 			if end < max {
 				n.pfx = "/" + path[offset:end]
 				offset = end

 				child := &node{
 					maxParams: numParams,
 					priority:  1,
 				}
 				n.children = []*node{child}
 				n = child
 			}

 		} else { // catchAll
 			if end != max || numParams > 1 {
 				panic("catch-all routes are only allowed at the end of the path in path '" + fullPath + "'")
 			}

 			if len(n.pfx)-len(n.children) > 0 && n.pfx[len(n.pfx)-1] == '/' {
 				panic("catch-all conflicts with existing handle for the path segment root in path '" + fullPath + "'")
 			}

 			// currently fixed width 1 for '/'
 			i--
 			if path[i] != '/' {
 				panic("no / before catch-all in path '" + fullPath + "'")
 			}

 			n.pfx = string(path[i]) + path[offset:i]

 			// first node: catchAll node with empty path
 			child := &node{
 				pfx:       "/",
 				wildChild: true,
 				nType:     catchAll,
 				maxParams: 1,
 			}
 			n.children = []*node{child}
 			n = child
 			n.priority++

 			// second node: node holding the variable
 			child = &node{
 				pfx:       path[i:],
 				nType:     catchAll,
 				maxParams: 1,
 				handle:    handle,
 				priority:  1,
 			}
 			n.children = []*node{child}

 			return
 		}
 	}

 	// insert remaining path part and handle to the leaf
 	n.pfx = n.pfx[:len(n.children)] + path[offset:]
 	n.handle = handle
 }

 // Returns the handle registered with the given path (key). The values of
 // wildcards are saved to a map.
 // If no handle can be found, a TSR (trailing slash redirect) recommendation is
 // made if a handle exists with an extra (without the) trailing slash for the
 // given path.
 func (n *node) getValue(path string) (handle Handle, p Params, tsr bool) {
 walk: // Outer loop for walking the tree
 	for {
 		prefix := n.pfx[len(n.children):]

 		if len(path) > len(prefix) {
 			if path[:len(prefix)] == prefix {
 				path = path[len(prefix):]
 				// If this node does not have a wildcard (param or catchAll)
 				// child, we can just look up the next child node and continue
 				// to walk down the tree
 				if !n.wildChild {
 					c := path[0]
 					for i := 0; i < len(n.children); i++ { // TODO: cache max?
 						if c == n.pfx[i] { // TODO: cache indices?
 							n = n.children[i]
 							continue walk
 						}
 					}

 					// Nothing found.
 					// We can recommend to redirect to the same URL without a
 					// trailing slash if a leaf exists for that path.
 					tsr = (path == "/" && n.handle != nil)
 					return

 				}

 				// handle wildcard child
 				n = n.children[0]
 				switch n.nType {
 				case param:
 					// find param end (either '/' or path end)
 					end := 0
 					for end < len(path) && path[end] != '/' {
 						end++
 					}

 					// save param value
 					if p == nil {
 						// lazy allocation
 						p = make(Params, 0, n.maxParams)
 					}
 					i := len(p)
 					p = p[:i+1] // expand slice within preallocated capacity
 					p[i].Key = n.pfx[len(n.children)+1:]
 					p[i].Value = path[:end]

 					// we need to go deeper!
 					if end < len(path) {
 						if len(n.children) > 0 {
 							path = path[end:]
 							n = n.children[0]
 							continue walk
 						}

 						// ... but we can't
 						tsr = (len(path) == end+1)
 						return
 					}

 					if handle = n.handle; handle != nil {
 						return
 					} else if len(n.children) == 1 {
 						// No handle found. Check if a handle for this path + a
 						// trailing slash exists for TSR recommendation
 						n = n.children[0]
 						tsr = (n.handle != nil && n.pfx[len(n.children):] == "/")
 					}

 					return

 				case catchAll:
 					// save param value
 					if p == nil {
 						// lazy allocation
 						p = make(Params, 0, n.maxParams)
 					}
 					i := len(p)
 					p = p[:i+1] // expand slice within preallocated capacity
 					p[i].Key = n.pfx[2:]
 					p[i].Value = path

 					handle = n.handle
 					return

 				default:
 					panic("invalid node type")
 				}
 			}
 		} else if path == prefix {
 			// We should have reached the node containing the handle.
 			// Check if this node has a handle registered.
 			if handle = n.handle; handle != nil {
 				return
 			}

 			if path == "/" && n.wildChild && n.nType != root {
 				tsr = true
 				return
 			}

 			// No handle found. Check if a handle for this path + a
 			// trailing slash exists for trailing slash recommendation
 			for i := 0; i < len(n.children); i++ {
 				if n.pfx[i] == '/' {
 					n = n.children[i]
 					tsr = (len(n.pfx)-len(n.children) == 1 && n.handle != nil) ||
 						(n.nType == catchAll && n.children[0].handle != nil)
 					return
 				}
 			}

 			return
 		}

 		// Nothing found. We can recommend to redirect to the same URL with an
 		// extra trailing slash if a leaf exists for that path
 		tsr = (path == "/") ||
 			(len(prefix) == len(path)+1 && prefix[len(path)] == '/' &&
 				path == prefix[:len(prefix)-1] && n.handle != nil)
 		return
 	}
 }

 // Makes a case-insensitive lookup of the given path and tries to find a handler.
 // It can optionally also fix trailing slashes.
 // It returns the case-corrected path and a bool indicating whether the lookup
 // was successful.
 func (n *node) findCaseInsensitivePath(path string, fixTrailingSlash bool) (ciPath []byte, found bool) {
 	ciPath = make([]byte, 0, len(path)+1) // preallocate enough memory
 	prefix := n.pfx[len(n.children):]

 	// Outer loop for walking the tree
 	for len(path) >= len(prefix) && strings.ToLower(path[:len(prefix)]) == strings.ToLower(prefix) {
 		path = path[len(prefix):]
 		ciPath = append(ciPath, prefix...)

 		if len(path) > 0 {
 			// If this node does not have a wildcard (param or catchAll) child,
 			// we can just look up the next child node and continue to walk down
 			// the tree
 			if !n.wildChild {
 				c := toLower(path[0])
 				for i := 0; i < len(n.children); i++ {
 					if c == toLower(n.pfx[i]) {
 						// must use recursive approach since both index and
 						// ToLower(index) could exist. We must check both.
 						out, found := n.children[i].findCaseInsensitivePath(path, fixTrailingSlash)
 						if found {
 							return append(ciPath, out...), true
 						}
 					}
 				}

 				// Nothing found. We can recommend to redirect to the same URL
 				// without a trailing slash if a leaf exists for that path
 				found = (fixTrailingSlash && path == "/" && n.handle != nil)
 				return
 			}

 			n = n.children[0]
 			switch n.nType {
 			case param:
 				// find param end (either '/' or path end)
 				k := 0
 				for k < len(path) && path[k] != '/' {
 					k++
 				}

 				// add param value to case insensitive path
 				ciPath = append(ciPath, path[:k]...)

 				// we need to go deeper!
 				if k < len(path) {
 					if len(n.children) > 0 {
 						path = path[k:]
 						n = n.children[0]
 						prefix = n.pfx[len(n.children):]
 						continue
 					}

 					// ... but we can't
 					if fixTrailingSlash && len(path) == k+1 {
 						return ciPath, true
 					}
 					return
 				}

 				if n.handle != nil {
 					return ciPath, true
 				} else if fixTrailingSlash && len(n.children) == 1 {
 					// No handle found. Check if a handle for this path + a
 					// trailing slash exists
 					n = n.children[0]
 					if n.pfx[len(n.children):] == "/" && n.handle != nil {
 						return append(ciPath, '/'), true
 					}
 				}
 				return

 			case catchAll:
 				return append(ciPath, path...), true

 			default:
 				panic("invalid node type")
 			}
 		} else {
 			// We should have reached the node containing the handle.
 			// Check if this node has a handle registered.
 			if n.handle != nil {
 				return ciPath, true
 			}

 			// No handle found.
 			// Try to fix the path by adding a trailing slash
 			if fixTrailingSlash {
 				for i := 0; i < len(n.children); i++ {
 					if n.pfx[i] == '/' {
 						n = n.children[i]
 						if (len(n.pfx)-len(n.children) == 1 && n.handle != nil) ||
 							(n.nType == catchAll && n.children[0].handle != nil) {
 							return append(ciPath, '/'), true
 						}
 						return
 					}
 				}
 			}
 			return
 		}
 	}

 	// Nothing found.
 	// Try to fix the path by adding / removing a trailing slash
 	if fixTrailingSlash {
 		if path == "/" {
 			return ciPath, true
 		}
 		if len(path)+1 == len(prefix) && prefix[len(path)] == '/' &&
 			strings.ToLower(path) == strings.ToLower(prefix[:len(path)]) &&
 			n.handle != nil {
 			return append(ciPath, prefix...), true
 		}
 	}
 	return
 }
	// Copyright 2013 Julien Schmidt. All rights reserved.
	// Use of this source code is governed by a BSD-style license that can be found
	// in the LICENSE file.

	package httprouter

	import (
	"strings"
	)

	func min(a, b int) int {
	if a <= b {
	return a
	}
	return b
	}

	func countParams(path string) uint8 {
	var n uint
	for i := 0; i < len(path); i++ {
	if path[i] != ':' && path[i] != '*' {
	continue
	}
	n++
	}
	if n >= 255 {
	return 255
	}
	return uint8(n)
	}

	func toLower(b byte) byte {
	if 'A' <= b && b <= 'Z' {
	b += 'a' - 'A'
	}
	return b
	}

	type nodeType uint8

	const (
	static nodeType = iota // default
	root
	param
	catchAll
	)

	type node struct {
	pfx string // first len(children) byte are indices, other are prefix
	wildChild bool
	nType nodeType
	maxParams uint8
	children []*node
	handle Handle
	priority uint32
	}

	// increments priority of the given child and reorders if necessary
	func (n *node) incrementChildPrio(pos int) int {
	n.children[pos].priority++
	prio := n.children[pos].priority

	// adjust position (move to front)
	newPos := pos
	for newPos > 0 && n.children[newPos-1].priority < prio {
	// swap node positions
	tmpN := n.children[newPos-1]
	n.children[newPos-1] = n.children[newPos]
	n.children[newPos] = tmpN

	newPos--
	}

	// build new index char string
	if newPos != pos {
	n.pfx = n.pfx[:newPos] + // unchanged prefix, might be empty
	n.pfx[pos:pos+1] + // the index char we move
	n.pfx[newPos:pos] + n.pfx[pos+1:] // rest without char at 'pos'
	}

	return newPos
	}

	// addRoute adds a node with the given handle to the path.
	// Not concurrency-safe!
	func (n *node) addRoute(path string, handle Handle) {
	fullPath := path
	n.priority++
	numParams := countParams(path)

	// non-empty tree
	if len(n.pfx) > 0 {
	prefix := n.pfx[len(n.children):]
	walk:
	for {
	// Update maxParams of the current node
	if numParams > n.maxParams {
	n.maxParams = numParams
	}

	// Find the longest common prefix.
	// This also implies that the common prefix contains no ':' or '*'
	// since the existing key can't contain those chars.
	i := 0
	max := min(len(path), len(prefix))
	for i < max && path[i] == prefix[i] {
	i++
	}

	// Split edge
	if i < len(prefix) {
	child := node{
	pfx: n.pfx[:len(n.children)] + prefix[i:],
	wildChild: n.wildChild,
	children: n.children,
	handle: n.handle,
	priority: n.priority - 1,
	}

	// Update maxParams (max of all children)
	for i := range child.children {
	if child.children[i].maxParams > child.maxParams {
	child.maxParams = child.children[i].maxParams
	}
	}

	n.children = []*node{&child}
	// []byte for proper unicode char conversion, see #65
	n.pfx = string([]byte{prefix[i]}) + path[:i]
	n.handle = nil
	n.wildChild = false
	}

	// Make new node a child of this node
	if i < len(path) {
	path = path[i:]

	if n.wildChild {
	n = n.children[0]
	n.priority++
	prefix = n.pfx[len(n.children):]

	// Update maxParams of the child node
	if numParams > n.maxParams {
	n.maxParams = numParams
	}
	numParams--

	// Check if the wildcard matches
	if len(path) >= len(prefix) && prefix == path[:len(prefix)] {
	// check for longer wildcard, e.g. :name and :names
	if len(prefix) >= len(path) \|\| path[len(prefix)] == '/' {
	continue walk
	}
	}

	panic("path segment '" + path +
	"' conflicts with existing wildcard '" + prefix +
	"' in path '" + fullPath + "'")
	}

	c := path[0]

	// slash after param
	if n.nType == param && c == '/' && len(n.children) == 1 {
	n = n.children[0]
	n.priority++
	prefix = n.pfx[len(n.children):]
	continue walk
	}

	// Check if a child with the next path byte exists
	for i := 0; i < len(n.children); i++ {
	if c == n.pfx[i] {
	i = n.incrementChildPrio(i)
	n = n.children[i]
	prefix = n.pfx[len(n.children):]
	continue walk
	}
	}

	// Otherwise insert it
	if c != ':' && c != '*' {
	// []byte for proper unicode char conversion, see #65
	n.pfx = n.pfx[:len(n.children)] + string([]byte{c}) + n.pfx[len(n.children):]
	child := &node{
	maxParams: numParams,
	}
	n.children = append(n.children, child)
	n.incrementChildPrio(len(n.children) - 1)
	n = child
	}
	n.insertChild(numParams, path, fullPath, handle)
	return

	} else if i == len(path) { // Make node a (in-path) leaf
	if n.handle != nil {
	panic("a handle is already registered for path ''" + fullPath + "'")
	}
	n.handle = handle
	}
	return
	}
	} else { // Empty tree
	n.insertChild(numParams, path, fullPath, handle)
	n.nType = root
	}
	}

	func (n *node) insertChild(numParams uint8, path, fullPath string, handle Handle) {
	var offset int // already handled bytes of the path

	// find prefix until first wildcard (beginning with ':'' or '*'')
	for i, max := 0, len(path); numParams > 0; i++ {
	c := path[i]
	if c != ':' && c != '*' {
	continue
	}

	// find wildcard end (either '/' or path end)
	end := i + 1
	for end < max && path[end] != '/' {
	switch path[end] {
	// the wildcard name must not contain ':' and '*'
	case ':', '*':
	panic("only one wildcard per path segment is allowed, has: '" +
	path[i:] + "' in path '" + fullPath + "'")
	default:
	end++
	}
	}

	// check if this Node existing children which would be
	// unreachable if we insert the wildcard here
	if len(n.children) > 0 {
	panic("wildcard route '" + path[i:end] +
	"' conflicts with existing children in path '" + fullPath + "'")
	}

	// check if the wildcard has a name
	if end-i < 2 {
	panic("wildcards must be named with a non-empty name in path '" + fullPath + "'")
	}

	if c == ':' { // param
	// split path at the beginning of the wildcard
	if i > 0 {
	n.pfx = ":" + path[offset:i]
	offset = i
	} else {
	n.pfx = ":" + n.pfx
	}

	child := &node{
	nType: param,
	maxParams: numParams,
	}
	n.children = []*node{child}
	n.wildChild = true
	n = child
	n.priority++
	numParams--

	// if the path doesn't end with the wildcard, then there
	// will be another non-wildcard subpath starting with '/'
	if end < max {
	n.pfx = "/" + path[offset:end]
	offset = end

	child := &node{
	maxParams: numParams,
	priority: 1,
	}
	n.children = []*node{child}
	n = child
	}

	} else { // catchAll
	if end != max \|\| numParams > 1 {
	panic("catch-all routes are only allowed at the end of the path in path '" + fullPath + "'")
	}

	if len(n.pfx)-len(n.children) > 0 && n.pfx[len(n.pfx)-1] == '/' {
	panic("catch-all conflicts with existing handle for the path segment root in path '" + fullPath + "'")
	}

	// currently fixed width 1 for '/'
	i--
	if path[i] != '/' {
	panic("no / before catch-all in path '" + fullPath + "'")
	}

	n.pfx = string(path[i]) + path[offset:i]

	// first node: catchAll node with empty path
	child := &node{
	pfx: "/",
	wildChild: true,
	nType: catchAll,
	maxParams: 1,
	}
	n.children = []*node{child}
	n = child
	n.priority++

	// second node: node holding the variable
	child = &node{
	pfx: path[i:],
	nType: catchAll,
	maxParams: 1,
	handle: handle,
	priority: 1,
	}
	n.children = []*node{child}

	return
	}
	}

	// insert remaining path part and handle to the leaf
	n.pfx = n.pfx[:len(n.children)] + path[offset:]
	n.handle = handle
	}

	// Returns the handle registered with the given path (key). The values of
	// wildcards are saved to a map.
	// If no handle can be found, a TSR (trailing slash redirect) recommendation is
	// made if a handle exists with an extra (without the) trailing slash for the
	// given path.
	func (n *node) getValue(path string) (handle Handle, p Params, tsr bool) {
	walk: // Outer loop for walking the tree
	for {
	prefix := n.pfx[len(n.children):]

	if len(path) > len(prefix) {
	if path[:len(prefix)] == prefix {
	path = path[len(prefix):]
	// If this node does not have a wildcard (param or catchAll)
	// child, we can just look up the next child node and continue
	// to walk down the tree
	if !n.wildChild {
	c := path[0]
	for i := 0; i < len(n.children); i++ { // TODO: cache max?
	if c == n.pfx[i] { // TODO: cache indices?
	n = n.children[i]
	continue walk
	}
	}

	// Nothing found.
	// We can recommend to redirect to the same URL without a
	// trailing slash if a leaf exists for that path.
	tsr = (path == "/" && n.handle != nil)
	return

	}

	// handle wildcard child
	n = n.children[0]
	switch n.nType {
	case param:
	// find param end (either '/' or path end)
	end := 0
	for end < len(path) && path[end] != '/' {
	end++
	}

	// save param value
	if p == nil {
	// lazy allocation
	p = make(Params, 0, n.maxParams)
	}
	i := len(p)
	p = p[:i+1] // expand slice within preallocated capacity
	p[i].Key = n.pfx[len(n.children)+1:]
	p[i].Value = path[:end]

	// we need to go deeper!
	if end < len(path) {
	if len(n.children) > 0 {
	path = path[end:]
	n = n.children[0]
	continue walk
	}

	// ... but we can't
	tsr = (len(path) == end+1)
	return
	}

	if handle = n.handle; handle != nil {
	return
	} else if len(n.children) == 1 {
	// No handle found. Check if a handle for this path + a
	// trailing slash exists for TSR recommendation
	n = n.children[0]
	tsr = (n.handle != nil && n.pfx[len(n.children):] == "/")
	}

	return

	case catchAll:
	// save param value
	if p == nil {
	// lazy allocation
	p = make(Params, 0, n.maxParams)
	}
	i := len(p)
	p = p[:i+1] // expand slice within preallocated capacity
	p[i].Key = n.pfx[2:]
	p[i].Value = path

	handle = n.handle
	return

	default:
	panic("invalid node type")
	}
	}
	} else if path == prefix {
	// We should have reached the node containing the handle.
	// Check if this node has a handle registered.
	if handle = n.handle; handle != nil {
	return
	}

	if path == "/" && n.wildChild && n.nType != root {
	tsr = true
	return
	}

	// No handle found. Check if a handle for this path + a
	// trailing slash exists for trailing slash recommendation
	for i := 0; i < len(n.children); i++ {
	if n.pfx[i] == '/' {
	n = n.children[i]
	tsr = (len(n.pfx)-len(n.children) == 1 && n.handle != nil) \|\|
	(n.nType == catchAll && n.children[0].handle != nil)
	return
	}
	}

	return
	}

	// Nothing found. We can recommend to redirect to the same URL with an
	// extra trailing slash if a leaf exists for that path
	tsr = (path == "/") \|\|
	(len(prefix) == len(path)+1 && prefix[len(path)] == '/' &&
	path == prefix[:len(prefix)-1] && n.handle != nil)
	return
	}
	}

	// Makes a case-insensitive lookup of the given path and tries to find a handler.
	// It can optionally also fix trailing slashes.
	// It returns the case-corrected path and a bool indicating whether the lookup
	// was successful.
	func (n *node) findCaseInsensitivePath(path string, fixTrailingSlash bool) (ciPath []byte, found bool) {
	ciPath = make([]byte, 0, len(path)+1) // preallocate enough memory
	prefix := n.pfx[len(n.children):]

	// Outer loop for walking the tree
	for len(path) >= len(prefix) && strings.ToLower(path[:len(prefix)]) == strings.ToLower(prefix) {
	path = path[len(prefix):]
	ciPath = append(ciPath, prefix...)

	if len(path) > 0 {
	// If this node does not have a wildcard (param or catchAll) child,
	// we can just look up the next child node and continue to walk down
	// the tree
	if !n.wildChild {
	c := toLower(path[0])
	for i := 0; i < len(n.children); i++ {
	if c == toLower(n.pfx[i]) {
	// must use recursive approach since both index and
	// ToLower(index) could exist. We must check both.
	out, found := n.children[i].findCaseInsensitivePath(path, fixTrailingSlash)
	if found {
	return append(ciPath, out...), true
	}
	}
	}

	// Nothing found. We can recommend to redirect to the same URL
	// without a trailing slash if a leaf exists for that path
	found = (fixTrailingSlash && path == "/" && n.handle != nil)
	return
	}

	n = n.children[0]
	switch n.nType {
	case param:
	// find param end (either '/' or path end)
	k := 0
	for k < len(path) && path[k] != '/' {
	k++
	}

	// add param value to case insensitive path
	ciPath = append(ciPath, path[:k]...)

	// we need to go deeper!
	if k < len(path) {
	if len(n.children) > 0 {
	path = path[k:]
	n = n.children[0]
	prefix = n.pfx[len(n.children):]
	continue
	}

	// ... but we can't
	if fixTrailingSlash && len(path) == k+1 {
	return ciPath, true
	}
	return
	}

	if n.handle != nil {
	return ciPath, true
	} else if fixTrailingSlash && len(n.children) == 1 {
	// No handle found. Check if a handle for this path + a
	// trailing slash exists
	n = n.children[0]
	if n.pfx[len(n.children):] == "/" && n.handle != nil {
	return append(ciPath, '/'), true
	}
	}
	return

	case catchAll:
	return append(ciPath, path...), true

	default:
	panic("invalid node type")
	}
	} else {
	// We should have reached the node containing the handle.
	// Check if this node has a handle registered.
	if n.handle != nil {
	return ciPath, true
	}

	// No handle found.
	// Try to fix the path by adding a trailing slash
	if fixTrailingSlash {
	for i := 0; i < len(n.children); i++ {
	if n.pfx[i] == '/' {
	n = n.children[i]
	if (len(n.pfx)-len(n.children) == 1 && n.handle != nil) \|\|
	(n.nType == catchAll && n.children[0].handle != nil) {
	return append(ciPath, '/'), true
	}
	return
	}
	}
	}
	return
	}
	}

	// Nothing found.
	// Try to fix the path by adding / removing a trailing slash
	if fixTrailingSlash {
	if path == "/" {
	return ciPath, true
	}
	if len(path)+1 == len(prefix) && prefix[len(path)] == '/' &&
	strings.ToLower(path) == strings.ToLower(prefix[:len(path)]) &&
	n.handle != nil {
	return append(ciPath, prefix...), true
	}
	}
	return
	}