Garry's Mod Wiki

Revision Difference

string.lower#511992

<function name="lower" parent="string" type="libraryfunc">⤶ <description>Changes any upper-case letters in a string to lower-case letters.</description>⤶ <realm>Shared and Menu</realm>⤶ <args>⤶ <arg name="str" type="string">The string to convert.</arg>⤶ </args>⤶ <rets>⤶ <ret name="" type="string">The original string, with all uppercase letters replaced with their lowercase variants.</ret>⤶ </rets>⤶ </function>⤶ ⤶ <example>⤶ <description>Demonstrates the use of this function.</description>⤶ <code>⤶ print( string.lower( "ABCDEFG" ) )⤶ print( string.lower( "AbCdefG" ) )⤶ print( string.lower( "abcdefg" ) )⤶ print( string.lower( "1234567890" ) )⤶ </code>⤶ <output>⤶ abcdefg⤶ ⤶ abcdefg⤶ ⤶ abcdefg⤶ ⤶ 1234567890⤶ </output>⤶ ⤶ </example>⤶ ⤶ ⤶ <example>⤶ <description>Demonstrates a common use for string.lower - case-insensitive user input.</description>⤶ <code>⤶ -- All keys in this table must be lowercase:⤶ local products = {}⤶ products.apple = "Buy an apple!"⤶ products.banana = "Buy a bunch of bananas!"⤶ products.tomato = "There's also tomatoes."⤶ ⤶ -- This function is case-insensitive, meaning "APPLE", "apple", and "APPle" are all the same.⤶ function GetProduct(userinput)⤶ return userinput, products[string.lower(userinput)]⤶ end⤶ ⤶ -- Demonstration:⤶ print(GetProduct("apple"))⤶ print(GetProduct("Apple"))⤶ print(GetProduct("APPLE"))⤶ print()⤶ print(GetProduct("banana"))⤶ print(GetProduct("BaNaNa"))⤶ </code>⤶ <outputfixedwidth>Fixed width</outputfixedwidth>⤶ <output>⤶ &amp;lt;nowiki&amp;gt;apple Buy an apple!⤶ Apple Buy an apple!⤶ APPLE Buy an apple!⤶ &amp;nbsp;⤶ banana Buy a bunch of bananas!⤶ BaNaNa Buy a bunch of bananas!&amp;lt;/nowiki&amp;gt;⤶ </output>⤶ ⤶ </example>