Cangjie Corpus

https://github.com/yolomao/cangjiecorpus-mirror
Admin
A high-quality knowledge base for the Cangjie programming language, supporting RAG technology and...
Tokens:2,019,220
Snippets:14,277
Trust Score:4.6
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### cjpm install examples: --path and --git

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/tools/source_zh_cn/tools/cjpm_manual_cjnative_community.md

Shows the two mutually exclusive installation modes for the cjpm install command: installing a local project via --path and installing a git project via --git. Only one of these modes can be configured at a time; if neither is set, the current directory's local project is installed by default.

```text
cjpm install --path path/to/project # 从本地路径 path/to/project 中安装
cjpm install --git url              # 从 git 对应地址安装
```

--------------------------------

### Output of get() result example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/manual/source_zh_cn/concurrency/use_thread.md

Output of the get() result example.

```text
result = 1
```

--------------------------------

### Wildcard example 3: * pro*.myfunc(...)

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/manual/source_zh_cn/Appendix/compile_options.md

Example 3: matches myfunc in any single-level package starting with pro, with any parameters. Use pro*.**.myfunc(...) to match multi-level packages.

```text
* pro*.myfunc(...)
```

--------------------------------

### compare(UInt8) example demonstrating Ordering.LT output

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/core/core_package_api/core_package_intrinsics.md

 main() { 

```código cangjie exemplo para demonstrar a interface Comparable compare() com valores UInt8, mostrando Ordering:LT como resultado da comparação Este código não requer nenhuma configuração prévia e ilustra o uso do método compare() da interface Comparable<U
main() {
    var num1: 

```

--------------------------------

### matchPosition() usage example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/regex/regex_package_api/regex_package_structs.md

Shows how to use matchPosition() with no arguments to get the whole match's start and end indices. The output shows positions for both matches.

```cangjie
import std.regex.*

main(): Unit {
    let r = Regex(#"(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})"#)
    let iter = r.lazyFindAll("2024-10-24&2025-01-01", group: true)
    while (true) {
        match (iter.next()) {
            case Some(md) =>
                println("# found: ${md.matchString()} and groupCount: ${md.groupCount()}")
                let pos = md.matchPosition(0)
                println("pos: [${pos.start}, ${pos.end}]")
            case None => break
        }
    }
}
```

```text
# found: 2024-10-24 and groupCount: 3
pos: [0, 10]
# found: 2025-01-01 and groupCount: 3
pos: [11, 21]
```

--------------------------------

### Initialize cjpm project

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/unittest/unittest_samples/unittest_getting_started.md

Initializes a `cjpm` project with the package name `example` and the example directory.

```bash
cjpm init example example
```

--------------------------------

### Perf setup method

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/unittest/unittest_package_api/unittest_package_structs.md

Initialization routine for this CPU counter. Called before each benchmark step.

```cangjie
func setup()
```

--------------------------------

### get(Int64) example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/core/core_package_api/core_package_structs.md

Shows how to use the get method to retrieve an element by index. The result is wrapped in Option, returning None if the index is out of bounds. The example prints Some(0) for index 0.

```cangjie
main() {
    let arr = [0, 1, 2]
    let num = arr.get(0)
    println(num)
}
```

```text
Some(0)
```

--------------------------------

### asResource() example with try-with-resource buruj buruj buruj buruj buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. Retrieving a pointer buruj buruj buruj buruj, freeing buruj buruj, buruj. buruj. buruj. buruj. 

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/core/core_package_api/core_package_intrinsics.md

Demonstrates retrieving a pointer buruj buruj buruj buruj buruj buruj buruj, buruj. buruj. buruj buruj, buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj.acquiring memory buruj buruj, buruj. buruj. buruj. buruj. buruj. buruj. buruj buruj, buruj. buruj. writing buruj buruj buruj buruj, buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj buruj, buruj buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. originating buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj buruj, buruj. buruj. syntax buruj buruj, buruj buruj. buruj. buruj. buruj. buruj buruj. buruj buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. snippet buruj buruj buruj buruj buruj buruj buruj buruj buruj, buruj. buruj. buruj. buruj. buruj. buruj. This snippet buruj buruj buruj buruj buruj buruj buruj, buruj. buruj buruj. buruj. buruj. buruj. buruj buruj. buruj buruj. buruj buruj. buruj. buruj. buruj buruj. buruj buruj. buruj. buruj. buruj. buruj buruj. buruj. buruj. buruj buruj. buruj. buruj buruj. buruj. buruj. buruj buruj. provenance: buruj. buruj. buruj. buruj. asResource() buruj buruj buruj buruj buruj buruj buruj buruj buruj buruj buruj buruj buruj buruj buruj buruj buruj buruj buruj, buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. bursa, buruj. buruj. heading buruj buruj buruj

```C#-like buruj buruj buruj buruj, buruj. 
foreign func malloc(size: UIntNative): CPointer buruj buruj buruj buruj, buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. bursa buruj. buruj. main() { let sizeofInt buruj buruj buruj buruj, buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. buruj. bursa buruj. buruj. var p1 = unsafely { malloc(sizeofInt buruj, buruj. bursa. buruj. buruj. buruj. 
```

--------------------------------

### Deterministic output of get() example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/manual/source_zh_cn/concurrency/use_thread.md

Deterministic output when get() is called before the main thread prints.

```text
New thread before sleeping
New thread after sleeping
Main thread
```

--------------------------------

### static func get(String) example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/reflect/reflect_package_api/reflect_package_classes.md

Gets the StructTypeInfo for a type by its qualified name. Throws InfoNotFoundException if no matching type is found, and IllegalTypeException if the type is not a StructTypeInfo. The example prints the type's qualified name.

```cangjie
public redef static func get(qualifiedName: String): StructTypeInfo
```

```cangjie
import std.reflect.*

import std.reflect.*

public struct Rectangular {}

main(): Unit {
    let ty = StructTypeInfo.get("default.Rectangular")
    println(ty)
    return
}
```

```text
default.Rectangular
```

--------------------------------

### Example project layout for bin-dependencies

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/tools/source_zh_cn/IDE/compilation_and_building_community.md

Directory layout for the example of importing three packages from the pro0 and pro1 modules. Shows the compiled .so and .cjo files, the source file main.cj, and the cjpm.toml configuration file.

```text
test

├── pro0

│    ├── libpro0_xoo.so

│    ├── xoo.cjo

│    ├── libpro0_yoo.so

│    └── yoo.cjo

├── pro1

│    ├── libpro1_zoo.so

│    └── zoo.cjo

├── src

│    └── main.cj

└── cjpm.toml
```

--------------------------------

### Multiple binary output example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/tools/source_zh_cn/tools/cjpm_manual_cjnative_community.md

Shows the output of building multiple executables and the resulting binary files.

```text
输入：cjpm build
输出：cjpm build success

输入：tree target/release/bin
输出：target/release/bin
|-- demo.aoo
|-- demo.boo
`-- demo
```

--------------------------------

### first() example with output

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/core/core_package_api/core_package_classes.md

Example of using first() to get the head element. The output shows Some(1).

```cangjie
main(): Int64 {
    var arr: Array<Int64> = [1, 2, 3, 4, 5]

    /* 获取迭代器对象 */
    var iter = arr.iterator()
    var head: Option<Int64> = iter.first()
    println(head)

    return 0
}
```

```text
Some(1)
```

--------------------------------

### static func start(String, Array<String>, ?Path, ?Map<String, String>, ProcessRedirect, ProcessRedirect, ProcessRedirect)

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/process/process_package_api/process_package_classes.md

Creates and runs a subprocess based on input parameters, returning a SubProcess instance. After calling this function, you must call wait or waitOutput to avoid zombie processes. This function is deprecated and will be replaced by launch.

```APIDOC
## static func start(String, Array<String>, ?Path, ?Map<String, String>, ProcessRedirect, ProcessRedirect, ProcessRedirect)

### Description
Creates and runs a subprocess based on input parameters, returning a SubProcess instance. After calling this function, you must call `wait` or `waitOutput` to avoid zombie processes. This function is deprecated and will be replaced by `launch`.

### Method
static func

### Signature
```cangjie
public static func start(command: String,
                        arguments: Array<String>,
                        workingDirectory!: ?Path = None,
                        environment!: ?Map<String, String> = None,
                        stdIn!: ProcessRedirect = Inherit,
                        stdOut!: ProcessRedirect = Inherit,
                        stdErr!: ProcessRedirect = Inherit): SubProcess
```

### Parameters
- **command** (String) - Required - Specifies the subprocess command. Must not contain null characters.
- **arguments** (Array<String>) - Required - Specifies the subprocess arguments. Strings in the array must not contain null characters.
- **workingDirectory** (?Path) - Optional - Named optional parameter. Specifies the working directory of the subprocess. Defaults to the current process working directory. Must be an existing directory, not an empty path, and must not contain null characters.
- **environment** (?Map<String, String>) - Optional - Named optional parameter. Specifies environment variables for the subprocess. Defaults to the current process environment. Keys must not contain null characters or '='. Values must not contain null characters.
- **stdIn** (ProcessRedirect) - Optional - Named optional parameter. Specifies standard input redirection. Defaults to Inherit.
- **stdOut** (ProcessRedirect) - Optional - Named optional parameter. Specifies standard output redirection. Defaults to Inherit.
- **stdErr** (ProcessRedirect) - Optional - Named optional parameter. Specifies standard error redirection. Defaults to Inherit.

### Returns
- **SubProcess** - Returns a subprocess instance.

### Exceptions
- **IllegalArgumentException** - Thrown when `command` contains null characters, or `arguments` array strings contain null characters, or `workingDirectory` is not an existing directory, is an empty path, or contains null characters, or `environment` keys contain null characters or '=', or values contain null characters, or `stdIn`, `stdOut`, `stdErr` are in file mode and the input file is closed or deleted.
- **ProcessException** - Thrown when memory allocation fails or the command corresponding to `command` does not exist.
```

--------------------------------

### Get Value Example with Output

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/reflect/reflect_package_api/reflect_package_classes.md

Shows how to get an InstanceVariableInfo via ClassTypeInfo and retrieve the value of a member variable from an instance. The output is Some(5).

```cangjie
import std.reflect.*

public class Rectangular {
    public var length = 4
    public var width = 5
}

main(): Unit {
    // 此处是通过 Rectangular 的类型的限定名称获取 ClassTypeInfo，也可以通过实例获取 ClassTypeInfo
    let ty = ClassTypeInfo.get("default.Rectangular")
    // 获取 InstanceVariableInfo
    var gip = ty.getInstanceVariable("width")
    // 获取实例值
    var r = Rectangular()
    let v = gip.getValue(r) as Int64
    println(v)
    return
}
```

```text
Some(5)
```

--------------------------------

### main.cj 源码示例

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/tools/source_zh_cn/tools/cjcov_manual_cjnative.md

一个简单的仓颉程序，输出 "hello world" 并返回 0。

```cangjie
main(): Int64 {
    print("hello world\n")
    return 0
}
```

--------------------------------

### trimStart(Array<T>) example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/core/core_package_api/core_package_structs.md

Trims from the start of the array, removing elements that are in the given set until the first element not in the set. The example prints [3, 1].

```cangjie
public func trimStart(set: Array<T>): Array<T>
```

```cangjie
main(): Int64 {
    let arr = [1, 2, 1, 3, 1].trimStart([1, 2])
    println(arr)
    return 0
}
```

```text
[3, 1]
```

--------------------------------

### Example: accessing constructor parameters

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/reflect/reflect_package_api/reflect_package_classes.md

Example showing how to get the parameters of a constructor using ClassTypeInfo and the parameters property. It iterates over constructors and their parameters, printing each parameter.

```cangjie
package test

import std.reflect.*

public class Rectangular {
    public var length = 4
    public var width = 5
    public var myName = ""
    public init() {}
    public init(name: String) {
        myName = name
    }
    public init(name: String, length: Int64, width: Int64) {
        myName = name
        this.length = length
        this.width = width
    }
}

main(): Unit {
    // 此处是通过 Rectangular 的类型的限定名称获取 ClassTypeInfo，也可以通过实例获取 ClassTypeInfo
    let ty = ClassTypeInfo.get("test.Rectangular")
    // 获取 constructors
    for (i in ty.constructors) {
        // 获取 parameters
        for (j in i.parameters) {
            println("${i} 的入参有 ${j}")
        }
    }
    return
}
```

--------------------------------

### 创建可执行文件并加载动态库

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/reflect/reflect_samples/dynload.md

创建 myExecutableDirectory 并初始化可执行文件，写入 main.cj 源文件，该文件使用 PackageInfo.load 加载动态库，并通过反射获取和修改全局变量。

```bash
$ cd .. && mkdir -p myExecutableDirectory && cd myExecutableDirectory
$ cjpm init
$ cat << EOF > src/main.cj
package myExecutableDirectory
import std.reflect.*

main(): Unit {
    // 加载仓颉动态库。
    let myPackage = PackageInfo.load("../myPackage/target/release/myPackage/libmyPackage")
    println(myPackage.name)
    TypeInfo.get("myPackage.MyPublicType") |> println

    let myPublicGlobalVariable0 = myPackage.getVariable("myPublicGlobalVariable0")
    (myPublicGlobalVariable0.getValue() as Int64).getOrThrow() |> println
    myPublicGlobalVariable0.setValue(666)
    (myPublicGlobalVariable0.getValue() as Int64).getOrThrow() |> println
}
EOF
```

--------------------------------

### Configuration.init()

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/unittest_common/unittest_common_package_api/unittest_common_package_classes.md

Constructs an empty Configuration instance.

```APIDOC
## Configuration.init()

### Description
Constructs an empty Configuration instance.

### Method
init

### Signature
public init()

### Parameters
None

### Returns
None
```

--------------------------------

### ClassTypeInfo.of(Any) example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/reflect/reflect_package_api/reflect_package_classes.md

Shows how to use the static method ClassTypeInfo.of(Any) to get the runtime type info of an instance. The example creates an instance and prints its type info.

```cangjie
package test

import std.reflect.*

public class Rectangular {}

main(): Unit {
    var r = Rectangular()
    let ty = ClassTypeInfo.of(r)
    println(ty)
    return
}
```

```text
test.Rectangular
```

--------------------------------

### at() example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/core/core_package_api/core_package_classes.md

Gets the element at index 2 using the at() method. The output is Some(3).

```cangjie
main(): Int64 {
    var arr: Array<Int64> = [1, 2, 3, 4, 5]

    /* 获取容器的迭代器对象 */
    var iter = arr.iterator()
    var num: Option<Int64> = iter.at(2)
    println(num)
    return 0
}
```

```text
Some(3)
```

--------------------------------

### static func start<U>(() -> DataStrategy<U>, String)

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/unittest/unittest_package_api/unittest_package_classes.md

Starts the composition and mapping of a DataStrategy. This is the entry point for creating a DataStrategyProcessor from a closure that generates a DataStrategy.

```APIDOC
## static func start<U>(() -> DataStrategy<U>, String)

### Description
Starts the composition and mapping of a DataStrategy. This is the entry point for creating a DataStrategyProcessor from a closure that generates a DataStrategy.

### Method
static func

### Signature
```cangjie
public static func start<U>(f: () -> DataStrategy<U>, name: String): DataStrategyProcessor<U> where U <: BenchInputProvider<T>
```

### Parameters
- **f** (() -> DataStrategy<U>) - Required - A closure that generates a data strategy.
- **name** (String) - Required - The test case name.

### Returns
- **DataStrategyProcessor<U>** - The data strategy processor.
```

--------------------------------

### static func start(() -> DataStrategy<T>, String, Int64)

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/unittest/unittest_package_api/unittest_package_classes.md

Starts the composition and mapping of a DataStrategy. This overload returns a SimpleProcessor and includes an additional parameter for refactoring purposes.

```APIDOC
## static func start(() -> DataStrategy<T>, String, Int64)

### Description
Starts the composition and mapping of a DataStrategy. This overload returns a SimpleProcessor and includes an additional parameter for refactoring purposes.

### Method
static func

### Signature
```cangjie
public static func start(f: () -> DataStrategy<T>, name: String, x!: Int64 = 0): SimpleProcessor<T>
```

### Parameters
- **f** (() -> DataStrategy<T>) - Required - A closure that generates a data strategy.
- **name** (String) - Required - The test case name.
- **x!** (Int64) - Optional - An additional parameter for refactoring to support different return types. Defaults to 0.

### Returns
- **SimpleProcessor<T>** - The test case processor.
```

--------------------------------

### ByteBuffer bytes() example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/io/io_package_api/io_package_classes.md

Gets the slice of unread data from the buffer and prints it as a string.

```cangjie
import std.io.ByteBuffer

main(): Unit {
    let inputData = "Hello World".toArray()
    let buffer = ByteBuffer(inputData)

    /* 从缓冲区中读取数据 */
    println(String.fromUtf8(buffer.bytes()))
}
```

```text
Hello World
```

--------------------------------

### Launch program with cjdb (target create / file)

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/tools/source_zh_cn/tools/cjdb_manual_cjnative.md

Two ways to load a program with launch: start the debugger with the program as an argument, or start the debugger and use the `file` command. Both set the current executable.

```text
~/0901/cangjie_test$ cjdb test
(cjdb) target create "test"
Current executable set to '/0901/cangjie-linux-x86_64-release/bin/test' (x86_64).
(cjdb)
```

```text
~/0901/cangjie_test$ cjdb
(cjdb) file test
Current executable set to '/0901/cangjie/test' (x86_64).
(cjdb)
```

--------------------------------

### indexOf(Array<T>, Int64) signature and example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/core/core_package_api/core_package_structs.md

Signature for the indexOf(Array<T>, Int64) overload that searches for a subarray starting from a given index. The example searches from index 3 and prints Some(4). The fromIndex is range-checked: values less than 0 start from index 0, and values greater than or equal to the array size return None.

```cangjie
public func indexOf(elements: Array<T>, fromIndex: Int64): Option<Int64>
```

```cangjie
main(): Int64 {
    let arr = [1, 2, 3, 4, 2, 3]
    let subArr = [2, 3]
    println(arr.indexOf(subArr, 3))
    return 0
}
```

```text
Some(4)
```

--------------------------------

### Example output of spawn example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/manual/source_zh_cn/concurrency/create_thread.md

Example output of the previous spawn example. The output may vary each run; this shows the new thread printing before the main thread.

```text
New thread before sleeping
Main thread
```

--------------------------------

### getValue example with output

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/reflect/reflect_package_api/reflect_package_classes.md

Example of using getValue to retrieve the value of an instance property. It obtains the ClassTypeInfo by qualified name, gets the InstancePropertyInfo for 'width', and prints the value. The output is Some(5).

```cangjie
import std.reflect.*

public class Rectangular {
    public var length = 4
    public prop width: Int64 {
        get() {
            5
        }
    }
}

main(): Unit {
    // 此处是通过 Rectangular 的类型的限定名称获取 ClassTypeInfo，也可以通过实例获取 ClassTypeInfo
    let ty = ClassTypeInfo.get("default.Rectangular")
    // 获取 InstancePropertyInfo
    var gip = ty.getInstanceProperty("width")

    // 获取实例值
    var r = Rectangular()
    var result = gip.getValue(r) as Int64
    println(result)
    return
}
```

```text
Some(5)
```

--------------------------------

### indexOf(T, Int64) signature and example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/core/core_package_api/core_package_structs.md

Signature for the indexOf(T, Int64) overload that searches for a single element starting from a given index. The example calls lastIndexOf with a subarray and index 3, printing Some(4). The fromIndex is range-checked: values less than 0 start from index 0, and values greater than or equal to the array size return None.

```cangjie
public func indexOf(element: T, fromIndex: Int64): Option<Int64>
```

```cangjie
main(): Int64 {
    let arr = [1, 2, 3, 4, 2, 3]
    let subArr = [2, 3]
    println(arr.lastIndexOf(subArr, 3))
    return 0
}
```

```text
Some(4)
```

--------------------------------

### Workspace configuration example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/tools/source_zh_cn/tools/cjpm_manual_cjnative_community.md

Example workspace configuration with members, build/test members, compile options, and dependencies.

```toml
[workspace]
members = ["aoo", "boo", "coo"]
build-members = ["aoo", "boo"]
test-members = ["aoo"]
compile-option = "-Woff all"
override-compile-option = "-O2"

[dependencies]
xoo = { path = "path_xoo" }

[ffi.c]
abc = { path = "libs" }
```

--------------------------------

### static func of<T>() example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/reflect/reflect_package_api/reflect_package_classes.md

Gets the StructTypeInfo for a given type T. Throws InfoNotFoundException if the type information cannot be obtained, and IllegalTypeException if the type is not a StructTypeInfo. The example prints the type's qualified name.

```cangjie
public redef static func of<T>(): StructTypeInfo
```

```cangjie
import std.reflect.*

public struct Rectangular {}

main(): Unit {
    let ty = StructTypeInfo.of<Rectangular>()
    println(ty)
    return
}
```

```text
default.Rectangular
```

--------------------------------

### main with no parameters

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/manual/source_zh_cn/package/entry.md

Valid entry point with no parameters. The return type must be Unit or an integer type; here Int64 is used.

```cangjie
// main.cj
main(): Int64 { // Ok.
    return 0
}
```

--------------------------------

### launch(String, Array<String>, ?Path, ?Map<String, String>, ProcessRedirect, ProcessRedirect, ProcessRedirect)

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/process/process_package_api/process_package_funcs.md

根据输入参数创建并运行一个子进程，并返回一个子进程实例。

```APIDOC
## launch(String, Array<String>, ?Path, ?Map<String, String>, ProcessRedirect, ProcessRedirect, ProcessRedirect)

### Description
根据输入参数创建并运行一个子进程，并返回一个子进程实例。调用该函数创建子进程后，需要调用 `wait` 或 `waitOutput` 函数，否则该子进程结束后成为的僵尸进程的资源不会被回收。

### Method
Function

### Signature
public func launch(command: String,
                        arguments: Array<String>,
                        workingDirectory!: ?Path = None,
                        environment!: ?Map<String, String> = None,
                        stdIn!: ProcessRedirect = Inherit,
                        stdOut!: ProcessRedirect = Inherit,
                        stdErr!: ProcessRedirect = Inherit): SubProcess

### Parameters
- **command** (String) - Required - 指定子进程命令，`command` 不允许包含空字符。
- **arguments** (Array<String>) - Required - 指定子进程参数，`arguments` 不允许数组中字符串中包含空字符。
- **workingDirectory** (?Path) - Optional - 命名可选参数，指定子进程的工作路径，默认继承当前进程工作路径，路径必须为存在的目录且不允许为空路径或包含空字符。
- **environment** (?Map<String, String>) - Optional - 命名可选参数，指定子进程环境变量，默认继承当前进程环境变量，`key` 不允许字符串中包含空字符或 `'='`，value 不允许字符串中包含空字符。
- **stdIn** (ProcessRedirect) - Optional - 命名可选参数，指定子进程重定向标准输入，默认继承当前进程标准输入。
- **stdOut** (ProcessRedirect) - Optional - 命名可选参数，指定子进程重定向标准输出，默认继承当前进程标准输出。
- **stdErr** (ProcessRedirect) - Optional - 命名可选参数，指定子进程重定向标准错误，默认继承当前进程标准错误。

### Returns
- **SubProcess** - 返回一个子进程实例。

### Exceptions
- **IllegalArgumentException** - 当入参 `command` 包含空字符，或者 `arguments` 数组中字符串中包含空字符，或者 `workingDirectory` 不是存在的目录或为空路径或包含空字符，或者 `environment` 表中 `key` 字符串中包含空字符或 `'='`，或者 `value` 字符串中包含空字符，或者 `stdIn`、`stdOut`、`stdErr` 输入为文件模式，输入的文件已被关闭或删除时，抛出异常。
- **ProcessException** - 当内存分配失败或 `command` 对应的命令不存在时，抛出异常。
```

--------------------------------

### Array slicing operator func [](Range<Int64>) with example

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/core/core_package_api/core_package_structs.md

Signature and example for getting an array slice using a Range. The range step must be 1; otherwise IllegalArgumentException is thrown. The example shows slicing and modifying the original array, with output [1, 2, 10].

```cangjie
public operator func [](range: Range<Int64>): Array<T>
```

```cangjie
main() {
    let arr = [0, 1, 2, 3, 4, 5]
    let slice = arr[1..4]
    arr[3] = 10
    println(slice)
}
```

```text
[1, 2, 10]
```

--------------------------------

### cjpm build --help 输出

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/tools/source_zh_cn/tools/cjpm_manual_cjnative_community.md

成功执行 `cjpm build --help` 后显示的结果，列出 build 命令的所有可用选项。

```text
Compile a local module and all of its dependencies.

Usage:
  cjpm build [option]

Available options:
  -h, --help                    help for build
  -i, --incremental             enable incremental compilation
  -j, --jobs <N>                the number of jobs to spawn in parallel during the build process
  -V, --verbose                 enable verbose
  -g                            enable compile debug version target
  --coverage                    enable coverage
  --cfg                         enable the customized option 'cfg'
  -m, --member <value>          specify a member module of the workspace
  --target <value>              generate code for the given target platform
  --target-dir <value>          specify target directory
  -o, --output <value>          specify product name when compiling an executable file
  -l, --lint                    enable cjlint code check
  --mock                        enable support of mocking classes in tests
  --skip-script                 disable script 'build.cj'.
```

--------------------------------

### Run Cangjie envsetup scripts for zip installation on Windows

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/manual/source_zh_cn/first_understanding/install_Community.md

Run the appropriate environment setup script for the zip installation of the Cangjie SDK on Windows. Choose the script based on your shell: envsetup.bat for CMD, envsetup.ps1 for PowerShell, and envsetup.sh for MSYS/bash. After running the script, verify the installation by executing 'cjc -v' in the same environment.

```bash
path\to\cangjie\envsetup.bat
```

```bash
. path\to\cangjie\envsetup.ps1
```

```bash
source path/to/cangjie/envsetup.sh
```

--------------------------------

### setValue example with output

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/reflect/reflect_package_api/reflect_package_classes.md

Shows how to set a static variable's value using setValue and then get it. The output is Some(20).

```cangjie
package test

import std.reflect.*

public class Rectangular {
    public static var area: Int64 = 10
}

main(): Unit {
    // 此处是通过 Rectangular 的类型的限定名称获取 ClassTypeInfo，也可以通过实例获取 ClassTypeInfo
    let ty = ClassTypeInfo.get("test.Rectangular")

    // 获取静态变量
    let sv = ty.getStaticVariable("area")

    // 设置值
    sv.setValue(20)
    println(sv.getValue() as Int64)
    return
}
```

```text
Some(20)
```

--------------------------------

### Source structure for multiple packages

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/tools/source_zh_cn/tools/cjpm_manual_cjnative_community.md

Example source structure for a module named demo, showing multiple packages.

```text
src
├── aoo
│    └── aoo.cj
├── boo
│    └── boo.cj
├── coo
│    └── coo.cj
└──  main.cj
```

--------------------------------

### Example invocation and output for cjpm-demo

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/tools/source_zh_cn/tools/cjpm_manual_cjnative_community.md

Example invocation and output of the cjpm-demo extension. Running 'cjpm demo hello,world' produces 'Output: hello,world'.

```text
输入：cjpm demo hello,world
输出：Output: hello,world
```

--------------------------------

### trimStart((T)->Bool) signature

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/core/core_package_api/core_package_structs.md

Trims from the start of the array, removing elements that satisfy the predicate until the first element that does not. No example is provided.

```cangjie
public func trimStart(predicate: (T)->Bool): Array<T>
```

--------------------------------

### cjlint -h help output with all options

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/tools/source_zh_cn/tools/cjlint_manual.md

Shows the full help output of `cjlint -h`, listing all command-line options (`-f`, `-e`, `-o`, `-r`, `-c`, `-m`, `--import-path`) with their usage examples. Use it to see the available flags and their default behaviors (e.g., `-r` defaults to `json`).

```text
Options:
   -h                      Show usage
                               eg: ./cjlint -h
   -f <value>              Detected file directory, it can be absolute paths or relative paths, if it is directory, default file name is cjReport
                               eg: ./cjlint -f fileDir -c . -m .
                               eg: ./cjlint -f "fileDir1 fileDir2" -c . -m .
   -e <v1:v2:...>          Excluded files, directories or configurations, splitted by ':'. Regular expressions are supported
                               eg: ./cjlint -f fileDir -e fileDir/a/:fileDir/b/*.cj
   -o <value>              Output file path, it can be absolute path or relative path
                               eg: ./cjlint -f fileDir -o ./out
   -r [csv|json]           Report file format, it can be csv or json, default is json
                               eg: ./cjlint -f fileDir -r csv -o ./out
   -c <value>              Directory path where the config directory is located, it can be absolute path or relative path to the executable file
                               eg: ./cjlint -f fileDir -c .
   -m <value>              Directory path where the modules directory is located, it can be absolute path or relative path to the executable file
                               eg: ./cjlint -f fileDir -m .
   --import-path <value>   Add .cjo search path
```

--------------------------------

### Generic class without Deriving

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/deriving/deriving_samples/deriving_user_guide.md

Shows a generic class Cell<T> without Deriving, as a starting point for the following examples.

```cangjie
class Cell<T> {
    Cell(let value: T) {}
}
```

--------------------------------

### Process.startTime

Source: https://github.com/yolomao/cangjiecorpus-mirror/blob/main/libs/std/process/process_package_api/process_package_classes.md

获取进程启动时间的属性。

```APIDOC
## [PROP] Process.startTime

### Description
获取进程启动时间，获取失败时返回 `DateTime.UnixEpoch`。

### Property
`public prop startTime: DateTime`

### Return Type
- **DateTime** - 进程启动时间。

```
Tokens:
Raw