GetUserdataType: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (decaps)
m (Fixed a markup typo)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Server client function}}
{{Server client function}}
{{New feature/item|3.0160|1.6|9768|This function gets the type of a userdata value, which is not always a [[element]] in the element tree.}}
{{New feature/item|3.0153|1.5.3|9768|This function gets the type of a userdata value, which is not always a [[element]] in the element tree.}}


==Syntax==
==Syntax==
Line 18: Line 18:
***''vector4'': a 4D vector, used in the [[Vector/Vector4|Vector4]] class.
***''vector4'': a 4D vector, used in the [[Vector/Vector4|Vector4]] class.
***''matrix'': a matrix, used in the [[Matrix]] class.
***''matrix'': a matrix, used in the [[Matrix]] class.
***''request'': a userdata type returned via [[fetchRemote]] (since [https://buildinfo.mtasa.com/?Revision=21436&Branch= r21436])
***''userdata'': a fallback userdata type return value, when no other type could be found for the object.
***''userdata'': a fallback userdata type return value, when no other type could be found for the object.
**'''Server only'''
**'''Server only'''

Latest revision as of 17:53, 2 March 2023

This function gets the type of a userdata value, which is not always a element in the element tree.

Syntax

string getUserdataType ( userdata value )

Required Arguments

Returns

Returns a string containing the specified userdata's type, or false plus an error message if the given value is not userdata.

Example

This example shows a function that can be used to work around the impossibility to transfer vectors as arguments when using triggerClientEvent and triggerServerEvent, by converting them into a table which can be used safely. 

function safeArgsForTransfer(...)
    local args = { ... }
    for index, arg in ipairs(args) do
        if type(arg) == "userdata" and getUserdataType(arg):match("vector") then
            -- Transform every kind of vector userdata to a table which can be transfered safely
            args[index] =
            {
                arg:getX(),
                arg:getY(),
                arg.getZ and arg:getZ() or nil,
                arg.getW and arg:getW() or nil,
                -- Extra field to distinguish from normal tables
                ["isVectorWorkaround"] = true
            }
        end
    end
    return unpack(args)
end

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/GetUserdataType?oldid=76247"