Skip to content

Buffer.Utils

Getting Started

The Utils component in Buffer serves to, for example, calculate the number of bytes required or directly convert a number of bytes to Kilobytes, Megabytes, or Gigabytes.

Methods

Getting the required bytes

To get the specific number of bytes, you will need a Schema and a table containing the values.

Note

This function is used in Buffer.Serialize. I recommend reading that page if you are lost.

 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
local Buffer = require(somewhere.Buffer)

local Utils = Buffer.Utils

--[[
    I really recommend to put : Buffer.BufferSchema for type checking, but it's optional.

    For any other type exepct String you will just need to put for example :

    {
        MyMessage = "String8" --> 8 is the max length of the string
    }

    but for non-defined length you will need to put something like this:

    {
        MyMessage = {
            Type = "String",
            Length = number
        }
    }

    Please note that when you put a string padding characters (string.char(31)) will be added to fill the remaining spaces
    but for example when you will call : Buffer.Deserialize(YourSchema,BufferComponent)

    all added characters will be automaticly removed
]]
local Schema : Buffer.BufferSchema = {
    MyMessage = {
        Type = "String",
        Length = 14,
    }
}

--Simple values (type checking is optional)
local Values : Buffer.BufferSchemaValue = {
    MyMessage = "Hello World"
}

print(Utils.GetRequiredBytes(Schema,Values)) --> this will return 14

Converting bytes

To convert bytes to Kilobytes, etc., the ConvertTo function would be used.

local Buffer = require(somewhere.Buffer)

local Utils = Buffer.Utils

--This will convert the current bytes to Kilobytes

print(Utils.ConvertByte("Kilobytes",1024)) --> this will return 1

--First argument is the convertion and second argument is the bytes
-- Supported convertions: Kilobytes, Megabytes, Gigabytes