Base64エンコーディング

base64モジュールは、文字列やバイナリデータを標準RFC 4648 Base64でエンコードし、元のバイト列にデコードします。

これはAPIリファレンスです。出力のみを示す式は成功時の値を例示し、ファイルシステムや転送の例ではデータを利用する前に省略可能な2番目の戻り値errorを確認します。username、password、encoded_image、user_inputなどの名前は、アプリケーションから渡される文字列です。

Base64はエンコーディングであり、暗号化や認証ではありません。秘密情報を隠したり、データが改変されていないことを検証したりする目的には使用しないでください。Basic認証の資格情報はTLS経由でのみ送信し、リテラルではなくアプリケーションが管理するシークレットストレージから取得してください。

ロード

local base64 = require("base64")

使用する前に、実行可能エントリのmodules:リストにbase64を追加してください。ファイルシステムとJSONの例では、それぞれfsとjsonも必要です。

エンコーディング

encode

バイナリデータを含む文字列をBase64としてエンコードします。

-- Encode text
local encoded, err = base64.encode("Hello, World!")
if err then return nil, err end
print(encoded)  -- "SGVsbG8sIFdvcmxkIQ=="

-- バイナリデータをエンコード（例: ファイルから）
local image_data = fs.get("app:data"):readfile("photo.jpg")
local image_b64 = base64.encode(image_data)

-- Encode JSON for transport
local json = require("json")
local payload, json_err = json.encode({user = "alice", action = "login"})
if json_err then return nil, json_err end
local token_part, token_err = base64.encode(payload)
if token_err then return nil, token_err end

-- Encode credentials
local credentials, credentials_err = base64.encode(username .. ":" .. password)
if credentials_err then return nil, credentials_err end
local auth_header = "Basic " .. credentials

戻り値: string, error — 空の入力は空文字列を返します

デコーディング

decode

Base64文字列を元のバイト列にデコードします。

-- Decode text
local decoded, decode_err = base64.decode("SGVsbG8sIFdvcmxkIQ==")
if decode_err then return nil, decode_err end
print(decoded)  -- "Hello, World!"

-- Decode with error handling
local data, err = base64.decode(user_input)
if err then
    return nil, errors.new("Invalid base64 data"):kind(errors.INVALID)
end

-- Decode binary data
local image_data, err = base64.decode(encoded_image)
if err then
    return nil, err
end
fs.get("app:data"):writefile("output.jpg", image_data)

-- base64でラップされたJSONドキュメントをデコード
local json = require("json")
local doc = json.decode(base64.decode(encoded_json))

最後のブロックは、区切り文字の処理だけを示しています。署名付きトークン形式の解析や検証は行いません。

戻り値: string, error — 空の入力は空文字列を返します

エラー

エラーの処理については、エラー処理を参照してください。