Fixed newlines in shoppinglist.inc and added blank line at the end.
This commit is contained in:
		| @@ -1,109 +1,109 @@ | ||||
| /* | ||||
|  * ============================================================================ | ||||
|  * | ||||
|  *  Zombie:Reloaded | ||||
|  * | ||||
|  *  File:          shoppinglist.inc | ||||
|  *  Type:          Core | ||||
|  *  Description:   Module to handle shopping list style lists. | ||||
|  * | ||||
|  *  Copyright (C) 2009  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 <http://www.gnu.org/licenses/>. | ||||
|  * | ||||
|  * ============================================================================ | ||||
|  */ | ||||
|  | ||||
| /** | ||||
|  * 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: | ||||
|  *  | ||||
|  * Parse: Take a string and dump out a list.  Simple. | ||||
|  * Set: Easy to do without this API, but maybe we can simplify it a little. | ||||
|  * Add: Should be a simple format.  May be in the API just to simplify it a bit.  | ||||
|  * 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. | ||||
|  *  | ||||
|  */ | ||||
|  | ||||
| /** | ||||
|  * 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 list_maxlen       The maximum length of the raw string. | ||||
|  * @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.  %d is the number.  Ex: "Apples x2" quantityformat: " x%d" | ||||
|  */ | ||||
| stock ShoppingListFormat(const String:list[], list_maxlen, String:shoppinglist[], slist_maxlen, const String:in_token[] = ",", const String:out_token[] = ",", const String:quantityformat[] = " x%d") | ||||
| { | ||||
| } | ||||
|  | ||||
| /** | ||||
|  * Set the list to a given string array of items. | ||||
|  *  | ||||
|  * @param list      The variable to store new list in. | ||||
|  * @param maxlen    The maximum length of the finished list. | ||||
|  * @param items     The items to construct into the list. | ||||
|  * @param maxitems  The number of array indexes from 0 to process for the list. | ||||
|  * @param token     The token to use to append the item.  Set to "" to auto-detect an existing token, if | ||||
|  *                  there is only one item in the list, this parameter won't be used. | ||||
|  */ | ||||
| stock ShoppingListConstruct(String:list[], maxlen, const String:items[][], maxitems, const String:token) | ||||
| { | ||||
| } | ||||
|  | ||||
| /** | ||||
|  * Add an item to the list. | ||||
|  *  | ||||
|  * @param list      The list to add item to. | ||||
|  * @param maxlen    The maximum length of the finished list. | ||||
|  * @param item      The item to add to the list. | ||||
|  * @param token     The token to use to append the item.  Set to "" to auto-detect an existing token, if | ||||
|  *                  this is the first item in the list, this parameter won't be used. | ||||
|  */ | ||||
| stock ShoppingListAppend(String:list[], maxlen, const String:item[], const String:token) | ||||
| { | ||||
| } | ||||
|  | ||||
| /** | ||||
|  * 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. | ||||
|  */ | ||||
| stock ShoppingListRemove(String:list[], maxlen, const String:item[]) | ||||
| { | ||||
| } | ||||
| /* | ||||
|  * ============================================================================ | ||||
|  * | ||||
|  *  Zombie:Reloaded | ||||
|  * | ||||
|  *  File:          shoppinglist.inc | ||||
|  *  Type:          Core | ||||
|  *  Description:   Module to handle shopping list style lists. | ||||
|  * | ||||
|  *  Copyright (C) 2009  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 <http://www.gnu.org/licenses/>. | ||||
|  * | ||||
|  * ============================================================================ | ||||
|  */ | ||||
|  | ||||
| /** | ||||
|  * 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: | ||||
|  *  | ||||
|  * Parse: Take a string and dump out a list.  Simple. | ||||
|  * Set: Easy to do without this API, but maybe we can simplify it a little. | ||||
|  * Add: Should be a simple format.  May be in the API just to simplify it a bit.  | ||||
|  * 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. | ||||
|  *  | ||||
|  */ | ||||
|  | ||||
| /** | ||||
|  * 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 list_maxlen       The maximum length of the raw string. | ||||
|  * @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.  %d is the number.  Ex: "Apples x2" quantityformat: " x%d" | ||||
|  */ | ||||
| stock ShoppingListFormat(const String:list[], list_maxlen, String:shoppinglist[], slist_maxlen, const String:in_token[] = ",", const String:out_token[] = ",", const String:quantityformat[] = " x%d") | ||||
| { | ||||
| } | ||||
|  | ||||
| /** | ||||
|  * Set the list to a given string array of items. | ||||
|  *  | ||||
|  * @param list      The variable to store new list in. | ||||
|  * @param maxlen    The maximum length of the finished list. | ||||
|  * @param items     The items to construct into the list. | ||||
|  * @param maxitems  The number of array indexes from 0 to process for the list. | ||||
|  * @param token     The token to use to append the item.  Set to "" to auto-detect an existing token, if | ||||
|  *                  there is only one item in the list, this parameter won't be used. | ||||
|  */ | ||||
| stock ShoppingListConstruct(String:list[], maxlen, const String:items[][], maxitems, const String:token) | ||||
| { | ||||
| } | ||||
|  | ||||
| /** | ||||
|  * Add an item to the list. | ||||
|  *  | ||||
|  * @param list      The list to add item to. | ||||
|  * @param maxlen    The maximum length of the finished list. | ||||
|  * @param item      The item to add to the list. | ||||
|  * @param token     The token to use to append the item.  Set to "" to auto-detect an existing token, if | ||||
|  *                  this is the first item in the list, this parameter won't be used. | ||||
|  */ | ||||
| stock ShoppingListAppend(String:list[], maxlen, const String:item[], const String:token) | ||||
| { | ||||
| } | ||||
|  | ||||
| /** | ||||
|  * 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. | ||||
|  */ | ||||
| stock ShoppingListRemove(String:list[], maxlen, const String:item[]) | ||||
| { | ||||
| } | ||||
|   | ||||
		Reference in New Issue
	
	Block a user