IdleTap-bot：导入自求闻百科

2026-08-03T08:20:59Z

导入自求闻百科

新页面

{{NoteTA/MediaWiki|G1=math|G2=IT}}
{{Documentation subpage}}{{High-use}}
主要提供5種[[編碼]]或[[解碼]]工具：
*JSON編碼/解碼
**包含一個「非函數物件之深層複製」的方法
*簡易的[[YAML]]解碼
*[[二进制]]編碼
*[[QR碼]]編碼（{{tl|QR}}）
*[[Base64]]編碼/解碼（{{tl|Base64}}）

== 使用方法 ==
=== [[JSON]] ===
==== 編碼 ====
;{{Anchor|_jsonEncode}}本模組._jsonEncode
能將Lua編碼為JSON的函數。與mw.text.jsonEncode不同在於，mw.text.jsonEncode遇到函數物件會出錯，而本模組的_jsonEncode會將函數物件以替代符號表示而不會出錯，能正常轉換各種Lua物件。

不支援模板直接呼叫。
==== 解碼 ====
JSON解碼僅需要使用mw.text.jsonDecode即可，本模組無特別提供。
=== [[YAML]] ===
==== 解碼 ====
;{{Anchor|yamlDecode}}本模組.yamlDecode
能將[[YAML]]解碼為[[Lua]]物件。支援模板直接呼叫。
{| class=wikitable
!原始碼
!輸出
|-
|<syntaxhighlight lang=yaml>{{#invoke:EncoderUtil|yamlDecode|
---
receipt: Oz-Ware Purchase Invoice
date: 2012-08-06
customer:
given: Dorothy
family: Gale}}</syntaxhighlight>
|{{#tag:syntaxhighlight|{{#invoke:EncoderUtil|yamlDecode|
---
receipt: Oz-Ware Purchase Invoice
date: 2012-08-06
customer:
given: Dorothy
family: Gale}}|lang=lua}}
|}

;{{Anchor|yaml2json}}本模組.yaml2json
將YAML轉換為JSON。支援模板直接呼叫。
{| class=wikitable
!原始碼
!輸出
|-
|<syntaxhighlight lang=yaml>{{#invoke:EncoderUtil|yaml2json|
---
receipt: Oz-Ware Purchase Invoice
date: 2012-08-06
customer:
given: Dorothy
family: Gale}}</syntaxhighlight>
|{{#tag:syntaxhighlight|{{#invoke:EncoderUtil|yaml2json|
---
receipt: Oz-Ware Purchase Invoice
date: 2012-08-06
customer:
given: Dorothy
family: Gale}}|lang=json}}
|}

=== [[二进制]]資料流 ===
本函數的功能並非設計給數字進行[[进制]]轉-{}-換之用，而是資料流的編解碼。若需要將數字進行[[进制]]轉-{}-換，請參考[[Module:BaseConvert]]或[[Module:BigNumber]]提供的[[Module:BigNumber#convertBase|convertBase函數]]。
==== 編碼 ====
;{{Anchor|_toBinary}}本模組._toBinary(x,digits)
能將一整數轉換成指定位數的二進制資料串。（供QR碼資料串編碼使用）

不支援模板直接呼叫。

;{{Anchor|_binaryEncode|binaryEncode}}本模組._binaryEncode(str)
能將一字串以[[UTF-8]]的格式編碼為二進制資料串。

有支援模板直接呼叫的函數<code>binaryEncode</code>
*原始碼{{tlxm|#invoke|EncoderUtil|binaryEncode|-{維基百科}-}}
*:輸出→{{#invoke:EncoderUtil|binaryEncode|維基百科}}

;{{Anchor|_hexadecimalEncode|hexadecimalEncode}}本模組._hexadecimalEncode(str)
能將一字串以[[UTF-8]]的格式編碼為[[十六进制]]資料串。

有支援模板直接呼叫的函數<code>hexadecimalEncode</code>
*原始碼{{tlxm|#invoke|EncoderUtil|hexadecimalEncode|-{維基百科，自由的百科全書}-}}
*:輸出→{{#invoke:EncoderUtil|hexadecimalEncode|維基百科，自由的百科全書}}

==== 解碼 ====
;{{Anchor|_binaryDecode|binaryDecode}}本模組._binaryDecode(bin)
一個二進制資料串解碼為[[UTF-8]]格式編碼的字串。

有支援模板直接呼叫的函數<code>binaryDecode</code>
*原始碼{{tlxm|#invoke|EncoderUtil|binaryDecode|111001111011011010101101111001011001111110111010111001111001100110111110111001111010011110010001}}
*:輸出→-{{{#invoke:EncoderUtil|binaryDecode|111001111011011010101101111001011001111110111010111001111001100110111110111001111010011110010001}}}-

;{{Anchor|_hexadecimalDecode|hexadecimalDecode}}本模組._hexadecimalDecode(hex)
一個[[十六进制]]資料串解碼為[[UTF-8]]格式編碼的字串。

有支援模板直接呼叫的函數<code>hexadecimalDecode</code>
*原始碼{{tlxm|#invoke|EncoderUtil|hexadecimalDecode|e7b6ade59fbae799bee7a791efbc8ce887aae794b1e79a84e799bee7a791e585a8e69bb8}}
*:輸出→-{{{#invoke:EncoderUtil|hexadecimalDecode|e7b6ade59fbae799bee7a791efbc8ce887aae794b1e79a84e799bee7a791e585a8e69bb8}}}-

=== [[QR碼]] ===
;{{Anchor|_get_libqrcode}}本模組._get_libqrcode()
初始化QR碼編碼程式庫。此處所有函數皆不支援模板直接呼叫。若要讓模板直接呼叫，請改用[[Module:QR]]和[[Module:RegularTiling]]提供的API（相依於本模組）。

初始化完的程式庫有以下成員：
*{{Anchor|qr.license}}'''license'''：記錄函式庫[[BSD许可证|三句版BSD授權條款]]的詳細資料。
*{{Anchor|qr.encode_string_numeric}}'''encode_string_numeric'''：將純數字字串編碼為[[QR碼]]格式的[[二进制]]資料流。
*{{Anchor|qr.encode_string_ascii}}'''encode_string_ascii'''：將純[[ASCII]]字串編碼為QR碼格式的[[二进制]]資料流。
*{{Anchor|qr.encode_string_binary}}'''encode_string_binary'''：將[[UTF-8]]字串編碼為QR碼格式的[[二进制]]資料流。
*{{Anchor|qr.encode_data}}'''encode_data'''：根據QR碼編碼模式將輸入的資料編碼為QR碼格式的[[二进制]]資料流。
*{{Anchor|qr.qrcode}}'''qrcode'''：生成完整[[QR碼]]二維碼的[[二进制]]資料流。
*{{Anchor|qr.get_mode}}'''get_mode'''：判斷輸入字串適合的[[QR碼]]編碼模式。
*{{Anchor|qr.get_length}}'''get_length'''：將資料長度資訊編碼為QR碼格式的二进制資料流。
*{{Anchor|qr.add_pad_data}}'''add_pad_data'''：生成QR碼的padding bits。
*{{Anchor|qr.get_generator_polynominal_adjusted}}'''get_generator_polynominal_adjusted'''：
*{{Anchor|qr.get_pixel_with_mask}}'''get_pixel_with_mask'''：取得QR碼特定位置的掩模。
*{{Anchor|qr.get_version_eclevel_mode_bistringlength}}'''get_version_eclevel_mode_bistringlength'''：
*{{Anchor|qr.get_version_eclevel}}'''get_version_eclevel'''：
*{{Anchor|qr.remainder}}'''remainder'''：各Ver的QR碼編碼時需要補餘的位元數量。
*{{Anchor|qr.arrange_codewords_and_calculate_ec}}'''arrange_codewords_and_calculate_ec'''：
*{{Anchor|qr.calculate_error_correction}}'''calculate_error_correction'''：計算糾錯碼
*{{Anchor|qr.convert_bitstring_to_bytes}}'''convert_bitstring_to_bytes'''：將長度為<math>8\times x</math>的二进制字串轉換為長度為<math>x</math>的數字陣列。
*{{Anchor|qr.get_matrix_and_penalty}}'''get_matrix_and_penalty'''：
*{{Anchor|qr.get_matrix_with_lowest_penalty}}'''get_matrix_with_lowest_penalty'''：
*{{Anchor|qr.bit_xor}}'''bit_xor'''：

=== [[Base64]] ===
;{{Anchor|_get_libbase64}}本模組._get_libbase64()
初始化[[Base64]]編碼程式庫。此處所有函數皆不支援模板直接呼叫。

初始化完的程式庫有以下成員：
*{{Anchor|base64.encode}}'''encode( str, encoder, usecaching )'''：將字串以指定編碼器編碼為[[Base64]]。
*{{Anchor|base64.decode}}'''decode( b64, decoder, usecaching )'''：將Base64資料流以指定解碼器進行解碼。
*{{Anchor|base64.makeencoder}}'''makeencoder( s62, s63, spad )'''：以給定的62、63字元和指定的spad生成編碼器。
*{{Anchor|base64.makedecoder}}'''makedecoder( s62, s63, spad )'''：以給定的62、63字元和指定的spad生成解碼器。

==== 編碼 ====
;{{Anchor|base64Encode}}本模組.base64Encode(str)
將字串編碼為標準的[[Base64]]資料流。支援模板直接呼叫。
*原始碼{{tlxm|#invoke|EncoderUtil|base64Encode|-{求闻百科}-}}
*:輸出→{{#invoke:EncoderUtil|base64Encode|求闻百科}}

==== 解碼 ====
;{{Anchor|base64Encode}}本模組.base64Decode(b64)
將給定的[[Base64]]資料流依照標準的[[Base64]]格式進行解碼。支援模板直接呼叫。
*原始碼{{tlxm|#invoke|EncoderUtil|base64Decode|5rGC6Ze755m+56eR}}
*:輸出→-{{{#invoke:EncoderUtil|base64Decode|5rGC6Ze755m+56eR}}}-

<includeonly>{{Sandbox other||


}}</includeonly>

Module:EncoderUtil/doc - 版本历史

IdleTap-bot：​导入自求闻百科

IdleTap-bot：导入自求闻百科