錨點入表要挨兩刀:別名拿到的是副本
/yaml-json 這頁自帶一臺手寫 YAML 解析器:模板 76073 位元組、1857 行,腳本內文 63822 字元在模板裡逐字命中 1 次,100 處函式宣告收斂到 99 個唯一名,外加 25 個 DOM id,解析器零外部依賴。本篇量的是它的結構層——錨點與別名的複製賬、合併鍵的先後、塊標量的行尾位元組、文件邊界的作用域。
值入別名表時先克隆一次,取用 *base 時再克隆一次。於是 b===a 為 false,b.sub===a.sub 也為 false:深兩層都是獨立物件。改 b 的 k 與 sub.z,a 和同樣引用 *base 的 c 紋絲不動。想靠別名共享可變引用,在這一頁是行不通的。
入表的時機也有細節:存錨點排在標籤 cast 之前。a: &s !!str 42 之後再寫 b: *s,得到的是 {"a":"42","b":42}——a 鍵下的值被 cast 成字串,入表的卻是未 cast 的數字,別名取回 42。
別名也不壓縮。同一錨點被引用 1、3、10 次,美化輸出分別是 130、256、697 字元,每多一次引用加 63 字元,且與手工內聯展開的輸出逐位元組相同。
圖 1 雙克隆鏈與展開賬:兩刀之後別名與原件互不相干,引用次數按 63 字元一份線性鋪開。
合併鍵:merged 先鋪,own 後寫
<< 的落位規則是先把合併來源鋪平、再寫本層自有鍵,同名時 own 贏。序列檔 <<: [*m1, *m2] 則倒序鋪平:m2 先鋪、m1 後鋪,同名反而是靠前的別名贏。合併進來的值同樣又是克隆,別名取到的仍不是原件本體。
| 寫法 | 實測輸出 | 賬 |
|---|---|---|
<<: *base 加同名 own 鍵 | 鍵序 x,y,z,y=9 | merged 先鋪、own 覆蓋 |
<<: [*m1, *m2] | x=1,鍵序 3 個 | 倒序鋪平,靠前別名贏 |
同一對映寫兩行 << | x=2 | 按出現序 push,後者覆蓋 |
三層鏈 d: {<<: *a} | 一次展開滿 3 鍵 | 錨點存的已是展開完的克隆 |
<< 指標量或陣列 | 鍵照常輸出,只警告 | 陣列按元素各報一條 |
非對映目標的警告原文是「合併鍵 << 引用的不是對映,已跳過」;陣列檔兩個元素就逐字報兩條同文,不升級為錯誤。
塊標量:六檔各有一本尾換行賬
用兩行內容加兩個空行再接一個鍵的同一排本量六檔:逐字輸出長 10、9、10、9、5、9 字元。尾隨換行上,| 與 > 各留 1 個,|- 與 >- 歸零,|+ 留 3 個(空行數加補的 1 個);若輸入以 |+ 塊直接收尾,只剩 2 個——最末空段在切行時已被去掉。摺疊檔 > 把相鄰普通行的接縫換成空格,空行折成 1 個換行,行首帶空格的行強制走換行檔。
圖 2 塊標量兩本賬:左邊是 chomping 尾換行,右邊是顯式縮排指示的切片口徑。
顯式縮排與報錯也各有原文:|2 按上級加 2 切片,內容多縮的部分原樣保留;|1 讓每行殘留 1 個前導空格;寫成 |0 或 |x 報「塊標量標記後面只能有 1-9 的縮排數字和 - + 修飾符」;|9 縮排不足報「要求至少 9 個空格」那句,message 全長 44 字元、UTF-8 下 108 位元組;自動檔參差報「塊標量的縮排比第一行內容少 1 個空格」。空塊 k: | 緊跟同級鍵得到空串。
錨點作用域:逐文件重建的別名表
別名表活不過文件邊界:每切一份文件就重建一次,兩次解析呼叫之間同樣零狀態。於是自引用構造不出死迴圈——a: &a 的塊檔裡寫 y: *a 報「第 3 行:引用了未定義的錨點 *a」,流式與序列檔同樣報錯,因為錨點要等整個值解析完才入表。跨文件借用也一樣,介面按原文行號報「第 4 行:引用了未定義的錨點 *x」;同名 &x 在下一份文件重定義則各自引用互不串。
多文件開關改變的是殼而非賬:未勾選時三個文件一起報「輸入包含 3 個文件(出現了多個 ---)」,輸出為空串,這句提示掛在 line 0 上、沒有行列元資訊;勾選後得到 3 元素陣列。若某文件自身先炸(例如上面那個跨文件引用),介面報的是該文件的別名錯而不是文件數錯。空串與只有註釋的輸入也各算 1 個文件、值為 null;--- k: v 同行寫法會被改寫成 4 空格縮排行照 parse。
# 與冒號的歸屬,順帶兩檔布林
# 要行首或空白領頭才成註釋:http://x#y 整串保留,b#c 粘著不算註釋,1#c 因此連數字都當字串;引號裡的 # 全是內容。冒號只認「後跟空白或行尾」,所以 a:b: c 的鍵是 a:b。嚴格與寬鬆兩檔在 yes/on/Off/Y/n/true/null 的樣本上翻轉 3 個鍵的型別;嚴格檔其實仍認 True/TRUE/false/FALSE 變體,頁面文案那句「布林只認 true/false」只能算部分一致。
介面全鏈路在 DOM 樁裡跑過:內建示例 YAML 輸出 1166 字元,統計行逐字是節點數 45、最大深度 7、文件數 1、鍵 34、陣列項 10;報錯面板分標題、行列、正文、原文指向、建議五段,列號等於該行縮排加 1,第 2 行的別名未定義錯渲染出「第 2 行 第 3 列」。四個開關每次 change 都同步落 localStorage 再重跑。瀏覽器真實繪製與輸入防抖合併本批未開瀏覽器,標未實測。
常見問題
Q:改別名取到的值,原件會跟著變嗎?
不會。入表與取用各克隆一次,別名與原件深兩層都不共享物件,改副本動不了原件,也輪不到別的別名。
Q:合併鍵和本層同名鍵誰贏?
own 贏——merged 先鋪、own 後寫。但序列檔 <<: [*m1, *m2] 內部是倒序鋪平,兩份來源同名時靠前的那份贏。
Q:上一份文件定義的錨點,這份接著用行不行?
不行,別名表逐文件重建,跨文件引用只會得到「引用了未定義的錨點」;想複用就在本文件內重新定義。
以上賬都在 YAML JSON 轉換頁核心上實測;拿不準 JSON 側輸出檔位時,可在 JSON 格式化頁對照美化與壓縮兩檔的位元組差;本頁標量型別解析那條線(布林詞表與數字判定)舊文已量過,見 YAML 標量型別重寫,本篇不重做那張表。