llIntegerToBase64

From Second Life Wiki
Revision as of 10:48, 11 October 2023 by Frionil Fang (talk | contribs) (refer to the inverse operation caveats for dropping more than padding characters)
Jump to navigation Jump to search

Summary

Function: string llIntegerToBase64( integer number );

Returns a string that is a Base64 big endian encode of number

• integer number

Examples

string ASCII7ToString(integer letter)
{
    if(letter >= 0x80 || letter < 0) return "";//Not valid ascii7 character
    return llBase64ToString(llIntegerToBase64(letter << 24));
}
// Packs a 24-bit unsigned integer value (0-16777215) to only 4 Base64 characters.
string Int24ToBase64(integer value)
{
    return llGetSubString(llIntegerToBase64(value<<8), 0, 3);
}
// unpacks a 4-character Base64 value to a 24-bit unsigned integer
integer Base64ToInt24(string value)
{
    return (llBase64ToInteger(value)>>8)&0xffffff; // Masking required to remove sign extension from bit-shifting
}
If you are looking for full Unicode translation, not just ASCII7 see: Combined_Library

Notes

  • Only the first 6 of the 8 characters returned are needed to decoded it back into an integer. The padding "==" can be safely removed for storage.
  • Combined with bit-shifting, further removing characters from the Base64 string allows more efficient packing of small values. See llBase64ToInteger caveats for specifics.

See Also

Deep Notes

Search JIRA for related Issues

Signature

function string llIntegerToBase64( integer number );