wenyan

文言編程術

文言者，以古漢語文法編程，編譯至JS/Python/Ruby。代碼如古文。

職

助撰、讀、調試、編譯文言代碼。能：

• 依規格或偽代碼撰新文言程式
• 文言↔JS/Python/Ruby雙向譯
• 讀編譯輸出或錯誤訊息以調試
• 以自然語言釋文言代碼
• 遷移既有TS/JS/Python/Ruby代碼庫至文言

速查

撰文言前，先熟此要。詳見references/。

型

型	關鍵字	值
數值	數	三, 一百二十, 三點一四
字串	言	「「text」」（雙角括號）
布爾	爻	陽(true), 陰(false)
數組	列	1起始！
對象	物	鍵值對
自動	元	編譯器推斷型

宣告

吾有一數。曰三。名之曰「x」。          // var x = 3
吾有一言。曰「「hello」」。名之曰「s」。  // var s = "hello"
吾有一爻。曰陰。名之曰「b」。           // var b = false
吾有一列。名之曰「arr」。               // var arr = []
吾有一物。名之曰「obj」。               // var obj = {}
有數五十。名之曰「n」。                 // var n = 50（簡寫）

多變量宣告：

吾有三數。曰一。曰三。曰五。名之曰「甲」曰「乙」曰「丙」。

重賦值：

昔之「x」者。今「y」是矣。              // x = y

流程控制

若「x」大於「y」者。                    // if (x > y) {
  ⋯⋯
也。                                   // }

若非。                                 // else {
  ⋯⋯
也。

為是十遍。⋯⋯云云。                     // for (i=0; i<10; i++) {...}
恆為是。⋯⋯云云。                       // while (true) {...}
凡「arr」中之「item」。⋯⋯云云。          // for (var item of arr) {...}
乃止。                                 // break

比較：大於、不大於、小於、不小於、等於、不等於

算術

加「x」以「y」。    // x + y
減「x」以「y」。    // x - y
乘「x」以「y」。    // x * y
除「x」以「y」。    // x / y
除「x」以「y」。所餘幾何。  // x % y

注意：加X以Y→X+Y，加X於Y→Y+X（於反序）

邏輯

夫「a」「b」中有陽乎。    // a || b
夫「a」「b」中無陰乎。    // a && b
變「x」。               // !x（取反）

術（函數）

定義：

吾有一術。名之曰「fn」。欲行是術。必先得一數。曰「x」。乃行是術曰。
  加「x」以一。名之曰「result」。
  乃得「result」。
是謂「fn」之術也。

調用：

施「fn」於「arg」。                // fn(arg)
施「fn」於「a」於「b」。           // fn(a, b)——自動柯里化！

返回：

乃得「x」      // return x
乃得矣        // return（末表達式）
乃歸空無       // return（空）

棧式嵌套調用

夫入棧，取N以施「fn」出N項調fn：

夫「a」。夫「b」。夫「c」。取二以施「f」。取二以施「g」。名之曰「result」。
// result = g(a, f(b, c))

棧特殊變量：

• 其→最近無名結果（兼清棧）
• 噫→棄/清無名棧

列（1起始！）

充「arr」以四。以二。              // arr.push(4, 2)
銜「a」以「b」。                  // a.concat(b)
夫「arr」之一。                   // arr[0]（1起始→JS 0起始）
夫「arr」之其餘。                 // arr.slice(1)
夫「obj」之「「key」」。           // obj["key"]
夫「arr」之長。                   // arr.length