/* * ============================================================================ * * Zombie:Reloaded * * File: shoppinglist.inc * Type: Core * Description: Module to handle shopping list style lists. * * Copyright (C) 2009-2013 Greyscale, Richard Helgeby * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . * * ============================================================================ */ /** * This file is meant for formatting a given string into a list formatted around the style of a shopping * list. * Example: * String: "Bacon, Egg, Egg, Milk, Butter" * Shopping List: "Bacon, Eggx2, Milk, Butter" * Function parameters will include options to change the "," to any character. As well as the "x2" format. * * More complex examples: * String: "Red - Green - Blue-Red- Green -Green - Yellow -Grey" Note: Horribly formatted, but we can handle it. * Shopping List: "Red(2)\nGreen(3)\nBlue\nYellow\nGrey" Note: We can change what to separate each item with, as well as how to display the quantity. * * List Options: * * Construct: Take a string and dump out a list. Simple. * Remove: Removes an item from the list. Must remove from the end to preserve list order. * * Scenario: * String: "Apple, Orange, Mango, Orange" * Shopping List: "Apple, Orange x2, Mango" * Remove: "Orange" * Remove first orange: "Apple, Mango, Orange" Different order. * Remove last orange: "Apple, Orange, Mango" Yay. * */ /** * @section String length defines. */ #define SHOPPINGLIST_MAXITEMS 32 #define SHOPPINGLIST_MAXLEN 32 /** * @endsection */ /** * Takes a given string and outputs a re-formatted shopping list styled list. See description above. * Note: This is for display purposes only, meaning there will be no API made to format the output of this function. * If you plan on the list being dynamic, store the raw string and use the API to edit those. * * @param list Raw string to be formatted. * @param shoppinglist Outputted shopping list. * @param slist_maxlen The maximum length of the shopping list. * @param in_token The token used to separate each item in the raw string. Ex: "Apple, Orange" Token: "," * @param out_token What to separate each item with in the shopping list. Ex: Token: "\n" List: "Apple\nOrange" * @param quantityformat How to show the quantity of an item for multi-listed items. ## is the number. Ex: "Apples x2" quantityformat: " x##" */ stock ShoppingListConstruct(const String:list[], String:shoppinglist[], slist_maxlen, const String:in_token[] = ",", const String:out_token[] = ",", const String:quantityformat[] = " x##") { // Put each item in a list. new String:items[SHOPPINGLIST_MAXITEMS][SHOPPINGLIST_MAXLEN]; ExplodeString(list, in_token, items, SHOPPINGLIST_MAXITEMS, SHOPPINGLIST_MAXLEN); // Put each item in a trie where we count each item. new Handle:trieItems = CreateTrie(); new item_count; new validstrings; // x = Array index. for (new x = 0; x < SHOPPINGLIST_MAXITEMS; x++) { // Trim off any whitespace. TrimString(items[x]); // If there are no more items left, exit the loop. if (!items[x][0]) break; // Reset item_count to 0, retrieve value, if it already exists, and set value + 1. item_count = 0; GetTrieValue(trieItems, items[x], item_count); SetTrieValue(trieItems, items[x], ++item_count); validstrings++; } // Initialize 'shoppinglist'. strcopy(shoppinglist, slist_maxlen, ""); decl String:item_formatted[SHOPPINGLIST_MAXLEN]; decl String:strQuantity[8]; // x = Array index. for (new x = 0; x < validstrings; x++) { // Get quantity count, in string and int. GetTrieValue(trieItems, items[x], item_count); // If the item_count is 0, this item is already in the shopping list. if (item_count == 0) continue; IntToString(item_count, strQuantity, sizeof(strQuantity)); strcopy(item_formatted, sizeof(item_formatted), items[x]); // Format the quantity on if there was more than 1. if (item_count > 1) { Format(item_formatted, sizeof(item_formatted), "%s%s", item_formatted, quantityformat); ReplaceString(item_formatted, sizeof(item_formatted), "##", strQuantity); } // Format the item onto the list. if (!shoppinglist[0]) { strcopy(shoppinglist, slist_maxlen, item_formatted); } else { Format(shoppinglist, slist_maxlen, "%s%s%s", shoppinglist, out_token, item_formatted); } SetTrieValue(trieItems, items[x], 0); } // Destroy the trie handle. CloseHandle(trieItems); } /** * Add an item to the list. * Notes: * For max number of items, and the max length of each item, see SHOPPINGLIST_* defines at the top. * * @param list The list to remove item from. * @param maxlen The maximum length of the finished list. * @param item The item to remove from the list. * @param token The token to remove with the item. * @return True if the item was found and removed, false if not found. */ public bool:ShoppingListRemove(String:list[], maxlen, const String:item[], const String:token[]) { // Explode the items into an array. new String:items[SHOPPINGLIST_MAXITEMS][SHOPPINGLIST_MAXLEN]; ExplodeString(list, token, items, SHOPPINGLIST_MAXITEMS, SHOPPINGLIST_MAXLEN); new validstrings; // x = Array index. for (new x = SHOPPINGLIST_MAXITEMS - 1; x >= 0; x--) { // Trim off any whitespace. TrimString(items[x]); if (StrEqual(item, items[x], false)) { // Nullify the matching string. items[x][0] = 0; // Re-copy each index after the matching string to overwrite it. for (new y = x; y < SHOPPINGLIST_MAXITEMS - 1; y++) items[y] = items[y + 1]; // Implode the array of strings back together into a full string. ImplodeStrings(items, validstrings + x, token, list, maxlen); return true; } // If this is a valid string, count it. if (items[x][0]) validstrings++; } return false; } /** * * * BROKEN STUFF * Attempted versions of the above code. * The working version is mostly (99%) Frus's code. * * */ /** * Add an item to the list. * * @param list The list to remove item from. * @param maxlen The maximum length of the finished list. * @param item The item to remove from the list. * @param token The token to remove with the item. * @return True if the item was found and removed, false if not found. */ /*stock bool:ShoppingListRemove(String:list[], maxlen, const String:item[], const String:token[]) { new itemindex = -1; new itemindex2 = -1; new pos; while (itemindex == itemindex2) { itemindex2 = pos = StrContains(list[pos], item, false); if (itemindex2 != -1) { itemindex = itemindex2; pos += 1; PrintToServer("%d %d %d %s", itemindex, itemindex2, pos, list[pos]); } else break; } if (itemindex == -1) return false; PrintToServer("position %d", itemindex); return true; }*/ /** * Add an item to the list. * * @param list The list to remove item from. * @param maxlen The maximum length of the finished list. * @param maxitems The maximum number of shopping items. * @param maxitemlen The maximum length of EACH item in the string. * @param item The item to remove from the list. * @param token The token to remove with the item. * @return True if the item was found and removed, false if not found. */ /*stock bool:ShoppingListRemove(String:list[], maxlen, maxitems, maxitemlen, const String:item[], const String:token[]) { // Default initialized value = false. new bool:success; // Put each item in a list. new String:items[maxitems][maxitemlen]; ExplodeString(list, token, items, maxitems, maxitemlen); // x = List index. for (new x = maxitems - 1; x >= 0; x--) { PrintToServer("%d %s", x, items[x]); if (StrEqual(items[x], item, false)) { strcopy(items[x], maxitemlen, ""); success = true; break; } } new String:items_after[maxitems][maxitemlen]; new count; // x = List index. for (new x = 0; x < maxitems; x++) { PrintToServer("%d \"%s\"", x, items[x]); if (!items[x][0]) continue; // Move valid item to new array, and increment count after. strcopy(items_after[count++], maxitemlen, items[x]); } // Join the valid strings back together. ImplodeStrings(items_after, count, token, list, maxlen); return success; }*/