Garry's Mod Wiki

Revision Difference

util.AddNetworkString#548625

<function name="AddNetworkString" parent="util" type="libraryfunc"> <description> Adds the specified string to a string table, which will cache it and network it to all clients automatically.<br/> Whenever you want to create a net message with <page>net.Start</page>, you must add the name of that message as a networked string via this function. If the passed string already exists, nothing will happen and the ID of the existing item will be returned. <note>Each unique network name needs to be pooled once - do not put this function call into any other functions if you're using a constant string. Preferable place for this function is in a serverside lua file, or in a shared file with the <page>net.Receive</page> function. The string table used for this function does not interfere with the engine string tables and has 4095 slots. This limit is shared among all entities, SetNW* and SetGlobal* functions. If you exceed the limit, you cannot create new variables, and you will get the following warning: ```lua Warning: Table networkstring is full, can't add [key] ``` Existing variables will still get updated without the warning. You can check the limit by counting up until <page>util.NetworkIDToString</page> returns nil</warning> returns nil</note> <warning>Existing variables will still get updated without the warning. You can check the limit by counting up until <page>util.NetworkIDToString</page> returns nil</warning></note> </description> <realm>Server</realm> <args> <arg name="str" type="string">Adds the specified string to the string table.</arg> </args> <rets> <ret name="" type="number">The id of the string that was added to the string table.<br/> Same as calling <page>util.NetworkStringToID</page>.</ret> </rets> </function>