Pair: xmlNodeSetValue

This function is made to be able to read tag values in XML files (eg. anything).

OOP Syntax Help! I don't understand this!

• Method: xmlnode:getValue(...)
• Variable: .value

Syntax

string|false xmlNodeGetValue ( xmlnode node )

Required Arguments

• node: The xmlnode of which you need to know the value.

Returns

• string|false: name

Returns the value of the node as a string if it was received successfully, false otherwise.

Code Examples

Example 1 Example 2 (OOP) Example 3 Example 4 (OOP)

client

This shows an example of a clientside XML file. You can use this to store user preferences and load them the next time the script loads. Almost always, you should have an options GUI for clients to interact with to set these values.

Since the XML will change, it should NOT be included in the resource's meta.xml file. MTA will think that file is corrupted and will download it again from the server. Instead, you should create the XML within the script, and then load it within the script on future script runs if it exists.

This xml will be created from the script following it below

<root>
    <hud_display>
        <IconSizeX>60</IconSizeX>
        <IconSizeY>60</IconSizeY>
    </hud_display>
    <hud_binds>
        <weaponSlot0>tab</weaponSlot0>
        <weaponSlot1>1</weaponSlot1>
    </hud_binds>
</root>

This script will create the xml or load it if it exists

function ClientResourceStart ()
  if (source ~= getResourceRootElement()) then return end --This event will happen with any resource start, isolate it to this resource
  xmlRootTree = xmlLoadFile ("userSettings.xml") --Attempt to load the xml file

  if (xmlRootTree) then -- If the xml loaded then...
    xmlHudBranch = xmlFindChild(xmlRootTree,"hud_display",0) -- Find the hud sub-node
    xmlBindsBranch = xmlFindChild(xmlRootTree,"hud_binds",0) -- Find the binds sub-node
    outputChatBox("XML Found and Loaded")
  else -- If the xml does not exist then...
    xmlRootTree = xmlCreateFile("userSettings.xml", "root") -- Create the xml file
    xmlHudBranch = xmlCreateChild(xmlRootTree, "hud_display") -- Create the hud sub-node under the root node
    xmlBindsBranch = xmlCreateChild(xmlRootTree, "hud_binds")-- Create the binds sub-node under the root node
    xmlNodeSetValue(xmlCreateChild(xmlHudBranch, "IconSizeX"), "60") --Create sub-node values under the hud sub-node
    xmlNodeSetValue(xmlCreateChild(xmlHudBranch, "IconSizeY"), "60") --Create sub-node values under the hud sub-node
    xmlNodeSetValue(xmlCreateChild(xmlBindsBranch, "weaponSlot0"), "tab") --Create sub-node values under the binds sub-node
    xmlNodeSetValue(xmlCreateChild(xmlBindsBranch, "weaponSlot1"), "1") --Create sub-node values under the binds sub-node
    outputChatBox("XML Created")
  end

  --Retrieve a single sub-node name or value
  outputChatBox("Node name: "..xmlNodeGetName(xmlFindChild(xmlHudBranch,"IconSizeX",0)), 0, 0, 255) --blue outputs
  outputChatBox("Node Value: "..xmlNodeGetValue(xmlFindChild(xmlHudBranch,"IconSizeX",0)), 0, 0, 255) --blue outputs

    --Retrieve multiple sub-node names or values
  xmlHudChildrenTable = xmlNodeGetChildren(xmlHudBranch) --Create a table of this branch's children
  for i,node in pairs(xmlHudChildrenTable) do --Loop through the branch's children for sub-nodes
        outputChatBox("Node name: "..xmlNodeGetName(node), 0, 255, 0) --green outputs
        outputChatBox("Node Value: "..xmlNodeGetValue(node), 0, 255, 0) --green outputs
  end
end
addEventHandler("onClientResourceStart", root, ClientResourceStart)

function ClientResourceStop ()
  if (source ~= getResourceRootElement()) then return end --This event will happen with any resource stop, isolate it to this resource

  xmlSaveFile(xmlRootTree) --Save the xml from memory for use next time
  xmlUnloadFile(xmlRootTree) --Unload the xml from memory
  outputChatBox( "Saved and unloaded the XML.")
end
addEventHandler("onClientResourceStop", root, ClientResourceStop)

client

OOP Required

This shows an example of a clientside XML file. You can use this to store user preferences and load them the next time the script loads. Almost always, you should have an options GUI for clients to interact with to set these values.

Since the XML will change, it should NOT be included in the resource's meta.xml file. MTA will think that file is corrupted and will download it again from the server. Instead, you should create the XML within the script, and then load it within the script on future script runs if it exists.

This xml will be created from the script following it below

<root>
    <hud_display>
        <IconSizeX>60</IconSizeX>
        <IconSizeY>60</IconSizeY>
    </hud_display>
    <hud_binds>
        <weaponSlot0>tab</weaponSlot0>
        <weaponSlot1>1</weaponSlot1>
    </hud_binds>
</root>

This script will create the xml or load it if it exists

function ClientResourceStart ()
    if (source ~= resourceRoot) then return end --This event will happen with any resource start, isolate it to this resource
    xmlRootTree = XML.load ("userSettings.xml") --Attempt to load the xml file

    if (xmlRootTree) then -- If the xml loaded then...
        xmlHudBranch = xmlRootTree:findChild("hud_display",0) -- Find the hud sub-node
        xmlBindsBranch = xmlRootTree:findChild("hud_binds",0) -- Find the binds sub-node
        outputChatBox("XML Found and Loaded")
    else -- If the xml does not exist then...
        xmlRootTree = XML("userSettings.xml", "root") -- Create the xml file
        xmlHudBranch = xmlRootTree:createChild("hud_display") -- Create the hud sub-node under the root node
        xmlBindsBranch = xmlRootTree:createChild("hud_binds")-- Create the binds sub-node under the root node

        xmlHudBranch:createChild("IconSizeX").value = "60" --Create sub-node values under the hud sub-node
        xmlHudBranch:createChild("IconSizeY").value = "60" --Create sub-node values under the hud sub-node
        xmlBindsBranch:createChild("weaponSlot0").value = "tab" --Create sub-node values under the binds sub-node
        xmlBindsBranch:createChild("weaponSlot1").value = "1" --Create sub-node values under the binds sub-node
        outputChatBox("XML Created")
    end

    --Retrieve a single sub-node name or value
    outputChatBox("Node name: "..xmlHudBranch:findChild("IconSizeX",0).name, 0, 0, 255) --blue outputs
    outputChatBox("Node Value: "..xmlHudBranch:findChild("IconSizeX",0).value, 0, 0, 255) --blue outputs

    --Retrieve multiple sub-node names or values
    xmlHudChildrenTable = xmlHudBranch.children --Create a table of this branch's children
    for i,node in pairs(xmlHudChildrenTable) do --Loop through the branch's children for sub-nodes
        outputChatBox("Node name: "..node.name, 0, 255, 0) --green outputs
        outputChatBox("Node Value: "..node.value, 0, 255, 0) --green outputs
    end
end
addEventHandler("onClientResourceStart", root, ClientResourceStart)

function ClientResourceStop ()
    if (source ~= resourceRoot) then return end --This event will happen with any resource stop, isolate it to this resource

    xmlRootTree:saveFile() --Save the xml from memory for use next time
    xmlRootTree:unload() --Unload the xml from memory
    outputChatBox( "Saved and unloaded the XML.")
end
addEventHandler("onClientResourceStop", root, ClientResourceStop)

server

In this example a sample value is returned from a XML file.

In order for the result to be valid, the xml file has to look like this:

<somenode>
  <somesubnode>somevalue</somesubnode>
</somenode>

local xmlFile = xmlLoadFile("exampleFile.xml") -- Open a file that we have already created
if (xmlFile) then -- If it's indeed opened
    local node = xmlFindChild(xmlFile, "somesubnode", 0) -- Find our first sub node
    local success = xmlNodeGetValue(node) -- Get the value of it
    xmlUnloadFile(xmlFile)

    if (success) then -- Check if it was successful
        outputChatBox (tostring(success)) -- Output "somevalue" to the chatbox
    end
end

server

OOP Required

In this example a sample value is returned from a XML file.

In order for the result to be valid, the xml file has to look like this:

<somenode>
  <somesubnode>somevalue</somesubnode>
</somenode>

local xmlFile = XML.load("exampleFile.xml") -- Open a file that we have already created
if (xmlFile) then -- If it's indeed opened
    local node = xmlFile:findChild("somesubnode", 0) -- Find our first sub node
    local success = node.value -- Get the value of it
    xmlFile:unload()

    if (success) then -- Check if it was successful
        outputChatBox (tostring(success)) -- Output "somevalue" to the chatbox
    end
end

See Also

XML Functions

• xmlCopyFile
• xmlCreateChild
• xmlCreateFile
• xmlDestroyNode
• xmlFindChild
• xmlLoadFile
• xmlNodeGetAttribute
• xmlNodeGetAttributes
• xmlLoadString
• xmlNodeGetChildren
• xmlNodeGetName
• xmlNodeGetParent
• xmlNodeGetValue
• xmlNodeSetAttribute
• xmlNodeSetName
• xmlNodeSetValue
• xmlUnloadFile
• xmlSaveFile

XML Elements

• xmlnode

Reference

• Scripting Functions