summaryrefslogtreecommitdiff
path: root/doc/classes/Marshalls.xml
blob: b66a1b919062da194f8fa88dc1c67ebb5b8fd416 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
<?xml version="1.0" encoding="UTF-8" ?>
<class name="Marshalls" inherits="Object" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
	<brief_description>
		Data transformation (marshalling) and encoding helpers.
	</brief_description>
	<description>
		Provides data transformation and encoding utility functions.
	</description>
	<tutorials>
	</tutorials>
	<methods>
		<method name="base64_to_raw">
			<return type="PackedByteArray" />
			<argument index="0" name="base64_str" type="String" />
			<description>
				Returns a decoded [PackedByteArray] corresponding to the Base64-encoded string [code]base64_str[/code].
			</description>
		</method>
		<method name="base64_to_utf8">
			<return type="String" />
			<argument index="0" name="base64_str" type="String" />
			<description>
				Returns a decoded string corresponding to the Base64-encoded string [code]base64_str[/code].
			</description>
		</method>
		<method name="base64_to_variant">
			<return type="Variant" />
			<argument index="0" name="base64_str" type="String" />
			<argument index="1" name="allow_objects" type="bool" default="false" />
			<description>
				Returns a decoded [Variant] corresponding to the Base64-encoded string [code]base64_str[/code]. If [code]allow_objects[/code] is [code]true[/code], decoding objects is allowed.
				[b]Warning:[/b] Deserialized objects can contain code which gets executed. Do not use this option if the serialized object comes from untrusted sources to avoid potential security threats such as remote code execution.
			</description>
		</method>
		<method name="raw_to_base64">
			<return type="String" />
			<argument index="0" name="array" type="PackedByteArray" />
			<description>
				Returns a Base64-encoded string of a given [PackedByteArray].
			</description>
		</method>
		<method name="utf8_to_base64">
			<return type="String" />
			<argument index="0" name="utf8_str" type="String" />
			<description>
				Returns a Base64-encoded string of the UTF-8 string [code]utf8_str[/code].
			</description>
		</method>
		<method name="variant_to_base64">
			<return type="String" />
			<argument index="0" name="variant" type="Variant" />
			<argument index="1" name="full_objects" type="bool" default="false" />
			<description>
				Returns a Base64-encoded string of the [Variant] [code]variant[/code]. If [code]full_objects[/code] is [code]true[/code], encoding objects is allowed (and can potentially include code).
			</description>
		</method>
	</methods>
</class>