Function FindMatchIn

internal/items/items.go:581–674

Provided a name and a list of items, find the first item that matches the name Will first provide a pair of starts-width and exact matches, and if not found then a contains.

(itemName string, items ...Item)

// Will first provide a pair of starts-width and exact matches,
// and if not found then a contains.
func FindMatchIn(itemName string, items ...Item) (pMatch Item, fMatch Item) {

	if len(itemName) > 1 {
		if itemName[0] == '!' { // Special meaning to specify an item

			var itemIdMatch int = 0
			var itemUUIDMatch uuid.UUID = uuid.UUID{}

			parts := strings.Split(itemName[1:], `:`)
			itemIdMatch, _ = strconv.Atoi(parts[0])

			if len(parts) > 1 {
				itemUUIDMatch, _ = uuid.FromString(parts[1])
			}

			for _, itm := range items {

				// If a uid was included, it takes priority over qualifying/disqualifying
				if !itemUUIDMatch.IsNil() {
					if itm.UUID != itemUUIDMatch {
						continue
					}
					return itm, itm
				}

				if itemIdMatch > 0 {
					if itm.ItemId != itemIdMatch {
						continue
					}
					return itm, itm
				}
			}
			return Item{}, Item{}
		}
	}

	itemName, itemNumber := util.GetMatchNumber(itemName)

	var matchItem Item
	var closeMatchItem Item

	var matchItemCt int = 0
	var closeMatchItemCt int = 0

	for _, i := range items {

		part, full := i.NameMatch(itemName, false)

		if part {
			closeMatchItemCt++
			if closeMatchItemCt == itemNumber {
				closeMatchItem = i
			}
		}

		if full {
			matchItemCt++
			if matchItemCt == itemNumber {