粤语编程语言技术文档

粤语编程语言技术文档

Cantonese 粤语編程語言.The Cantonese programming language. 项目地址: https://gitcode.com/gh_mirrors/ca/Cantonese

安装指南

要安装粤语编程语言，您只需执行以下命令：

pip install Cantonese

这将通过Python包管理器pip下载并安装该语言的库。

项目使用说明

粤语编程语言允许开发者使用粤语语法编写代码，让编程体验更加本土化和有趣。以下是基础的使用示例和重要概念简介。

基础语法示例

• Hello World

  畀我睇下「"Hello World!"」點樣先？
  

• 变量赋值

  介紹返「A」係 1
  

• 控制结构

  • 循环 (for 和 while)

    「A」从 1 行到 100
        畀我睇下「A」點樣先??
    到步
    

  • 条件判断 (if, else)

    如果 |A 係 2| 嘅话 => {
        畀我睇下「"A 係 2"」點樣先??
    }
    唔係 嘅话 => {
        畀我睇下「"A 唔係 2"」點樣先??
    }
    

• 函数定义与调用

  介紹返 $get_max
      |数字1, 数字2| 点部署
          如果 |数字1 比唔上 数字2| 嘅话 => {
              还数「数字2」
          }
          唔係 嘅话 => {
              还数「数字1」
          }
  搞掂
  
  番薯味 => 介绍返 结果 係 
      get_max 下 -> 23, 17
  畀我睇下 结果 點樣先??
  

• 异常处理

  揾到「NameError」嘅话 => {
      畀我睇下 "揾到NameError" 點樣先？
  }
  

• 面向对象编程

  介紹返 duck 係 乜X {
      佢嘅 |性别| 係 "公"
      佢識得 |游下水| => {
          畀我睇下 "Duck is swimming" 點樣先？
      }
  }
  

API使用文档

本语言的API主要体现在关键字和内置函数上，如介紹返用于声明变量，如果...嘅话用于条件判断等。具体的API细节需要参考源码和提供的文档。由于这是一个特色化的语言，没有传统的API接口文档，更多的功能通过示例代码展现。

项目安装方式

已包含在“安装指南”中，通过pip安装即可。

如何运行

运行粤语编写的脚本，可直接使用命令行，例如：

cantonese your_script.cantonese

对于转换成Python或HTML等其他形式的使用，参考以下命令：

• 转换为Python源码：

  cantonese your_script.cantonese -to_py
  

• 生成网页：

  cantonese web_hello.cantonese -to_web -compile
  

此文档基于项目Readme进行了详细扩展，旨在提供清晰的引导，帮助用户理解和使用粤语编程语言。通过上述内容，用户应能够开始探索并应用这种独特的编程工具。

Cantonese 粤语編程語言.The Cantonese programming language. 项目地址: https://gitcode.com/gh_mirrors/ca/Cantonese