Garry's Mod Wiki

Revision Difference

string.gsub#511997

<function name="gsub" parent="string" type="libraryfunc">⤶ <description>This functions main purpose is to replace certain character sequences in a string using <page>Patterns</page>.</description>⤶ <realm>Shared and Menu</realm>⤶ <args>⤶ <arg name="string" type="string">String which should be modified.</arg>⤶ <arg name="pattern" type="string">The pattern that defines what should be matched and eventually be replaced.</arg>⤶ <arg name="replacement" type="string">In case of a string the matches sequence will be replaced with it.&#xA;&#xA;In case of a table, the matched sequence will be used as key and the table will tested for the key, if a value exists it will be used as replacement.&#xA;&#xA;In case of a function all matches will be passed as parameters to the function, the return value(s) of the function will then be used as replacement.</arg>⤶ <arg name="maxReplaces" type="number" default="nil">Maximum number of replacements to be made.</arg>⤶ </args>⤶ <rets>⤶ <ret name="" type="string">replaceResult</ret>⤶ <ret name="" type="number">replaceCount</ret>⤶ </rets>⤶ </function>⤶ ⤶ <example>⤶ <description>Replaces "hello" with "hi" in the string "hello there!"</description>⤶ <code>string.gsub("hello there!", "hello", "hi")</code>⤶ <output>hi there!</output>⤶ ⤶ </example>