FazBrowse GitHub Viewer
|
Trending
|
URL:
|
Home
Tools:
[Download Repo ZIP]
[View Raw Code]
[Original HTTPS Page]
livecode/docs/dictionary/function/arrayEncode.lcdoc at develop · livecodeali/livecode · GitHub
livecodeali
/
livecode
Public
forked from
livecode/livecode
Notifications
You must be signed in to change notification settings
Fork
1
Star
0
Code
Pull requests
0
Actions
Projects
Security and quality
0
Insights
Additional navigation options
Code
Pull requests
Actions
Projects
Security and quality
Insights
Expand file tree
Breadcrumbs
livecode
/
docs
/
dictionary
/
function
/
arrayEncode.lcdoc
Copy path
More file actions
More file actions
Latest commit
History
History
History
58 lines (41 loc) · 1.8 KB
Breadcrumbs
livecode
/
docs
/
dictionary
/
function
/
arrayEncode.lcdoc
Copy path
File metadata and controls
58 lines (41 loc) · 1.8 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
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
Name: arrayEncode
Type: function
Syntax: arrayEncode(<array>,[<encodeVersion>])
Summary:
Serializes a LiveCode array.
Introduced: 3.5
OS: mac, windows, linux, ios, android
Platforms: desktop, server, mobile
Example:
savePreferencesData "displayOptions", arrayEncode(sDisplayOptionsArray)
Example:
write urlEncode(arrayEncode(tArray)) to socket tSocket
Parameters:
array (array):
The array is a LiveCode array.
encodeVersion:
If present, and >= "7.0" then the array is encoded in such a way as to
preserve unicode in keys and values, as well as NUL chars in keys and
values
Returns (string):
The <arrayEncode> function returns a string of binary data that
represents the data and structure of the specified array.
Description:
Use the <arrayEncode> function to convert an array into a string so that
it can be saved to a file or sent across a network.
The string returned by the arrayEncode function is designed to be used
to transfer arrays to remote machines or to save them to a file on disk.
It is an opaque, binary encoding of the data contained in the array. The
original array can be rebuilt by using the arrayDecode function. Encoded
arrays cannot easily be modified, and should always be converted back
into real arrays before attemping to access or modify them.
To send an encoded array to a remote process over TCP/IP, it should be
encoded using the URLEncode function, as it may contain characters not
suitable for use in URLs.
>*Note:* Arrays in LiveCode are un-ordered. This means in particular
> that encoding two arrays will not necessarily produce the same result,
> even if the arrays had the same elements. To compare two arrays,
> simply use the = operator directly on them rather than encoding them
> first.
References: write to socket (command), keys (function),
arrayDecode (function), [] (keyword)
Back
|
FazBrowse Home
|
New Git URL