Julia 1.5.3 Documentation

《Julia 1.5.3 Documentation》总结如下： --- ### 1. 文档编写规范 - 使用中文字符（如`α = 1`）而非 LaTeX 格式（如 `\alpha = 1`）。 - 文档字符串的起始和结束`"""`应单独占行，使开始和结束位置清晰。 - 遵循代码周围的行长度限制，建议每行不超过 92 个字符。 - 为自定义类型提供实现信息的「Implementation」部分，说明需要重写的函数和自动回退的函数。 - 对于长文档，可以使用「# Extended help」头线分隔，典型帮助模式仅显示头线以上内容，完整帮助可通过在表达式前添加`?`访问（如`??foo`）。 --- ### 2. 访问文档 - 在 REPL 或 IJulia 中，输入 `?` 后跟函数或宏的名称并按回车，即可查看文档，例如 `?cos`、`?@time`、`?r`。 - 在 Juno 中，使用 `Ctrl-J, Ctrl-D` 可查看光标下对象的文档。 --- ### 3. 函数与方法 - Julia 函数可能有多个实现（方法）。通常情况下，只需文档化最通用的方法或函数本身，避免重复信息。 - 特定方法仅需在行为与通用方法不同时进行文档化。 --- ### 4. REPL 功能 - Julia 的 REPL（读取-评估-打印循环）是交互式命令行工具，支持： - 快速评估 Julia 表达式； - 搜索历史记录、标签补全、shortcut 键绑定； - 专用帮助模式和 Shell 模式。 - 启动 REPL：直接运行 `julia` 或双击可执行文件。 - 退出 REPL：空行输入 `^D` 或运行 `exit()`。 - REPL 提供四种操作模式，默认模式为 Julian 提示（`julia>`），用户可输入 Julia 表达式，结果会绑定到变量 `ans`。 --- ### 5. 错误处理 - 提供了多种错误类型，包括： - `ArgumentError`：函数调用参数不匹配。 - `AssertionError`：断言条件不成立。 - `BoundsError`：数组索引越界。 - 自定义错误提示（实验性功能）：通过 `Experimental.register_error_hint` 注册错误提示，建议在 `if isdefined(Base.Experimental, :register_error_hint)` 块中使用。 --- ### 6. 控制流 Julia 提供多种控制流构造： - 复合表达式：`begin` 和 `;`。 - 条件评估：`if-elseif-else` 和 `?:`（三元运算符）。 - 短路评估：`&&`、`||` 和链式比较。 - 重复评估：`while` 和 `for` 循环。 - 异常处理：`try-catch`、`error` 和 `throw`。 - 任务（协程）：`yieldto`。 --- ### 7. 新库特性 - 函数组合：`∘(f) = f`，支持单参数。 - 一参数方法：`startswith(x)` 和 `endswith(x)`，返回部分应用版本。 - `isapprox(x)` 返回函数，类似 `isequal(x)`。 - `@NamedTuple{key1::Type1, ...}` 宏，方便 NamedTuple 声明。 - `Ref{NTuple{N,T}}` 可传递给 `Ptr{T}/Ref{T}` ccall 签名。 - 支持整数位类型的 `%` 和转换（如 `signed(unsigned_type)`）。 - `accumulate`、`cumsum` 和 `cumprod` 支持元组和任意迭代器。 - `splice!` 支持任意可迭代对象。 - `@view` 和 `@views` 支持 `a[begin]` 语法。 - `open` 接受 `lock` 关键字，控制多线程安全访问。 - 审视宏（如 `@which`、`@code_typed`）支持 `do-block` 和点语法。 - `count` 接受 `dims` 关键字，`count!` 类似 `sum!`。 - `peek` 导出并接受类型，从流中查间。 --- ### 8. 实用工具 - `Base.Docs.apropos`：在文档中搜索字符串，忽略大小写。 - `InteractiveUtils.varinfo`：返回模块中导出全局变量的信息表。 - `InteractiveUtils.versioninfo`：打印 Julia 版本信息。 - `InteractiveUtils.methodswith`：返回指定类型或模块的方法数组。 - `InteractiveUtils.subtypes`：返回 immediatge 子类型列表。 --- 以上是《Julia 1.5.3 Documentation》的核心内容总结。