Ziglings

通过修复微小的故障程序来学习 Zig 编程语言。「Learn the Zig programming language by fixing tiny broken programs.」

Github星跟踪图

Ziglings

Welcome to Ziglings! This project contains a series of tiny broken programs.
By fixing them, you'll learn how to read and write
Zig
code.

ziglings

Those tiny broken programs need your help! (You'll also save the planet from
evil aliens and help some friendly elephants stick together, which is very
sweet of you.)

This project was directly inspired by the brilliant and fun
rustlings
project for the Rust language.
Indirect inspiration comes from Ruby Koans
and the Little LISPer/Little Schemer series of books.

Intended Audience

This will probably be difficult if you've never programmed before.
But no specific programming experience is required. And in particular,
you are not expected to have any prior experience with "systems programming"
or a "systems" level language such as C.

Each exercise is self-contained and self-explained. However, you're encouraged
to also check out these Zig language resources for more detail:

Also, the Zig community is incredibly friendly and helpful!

Getting Started

Install a development build of the Zig compiler.
(See the "master" section of the downloads page.)

Verify the installation and build number of zig like so:

$ zig version
0.8.0-dev.1983+xxxxxxxxx

Clone this repository with Git:

$ git clone https://github.com/ratfactor/ziglings
$ cd ziglings

Then run zig build and follow the instructions to begin!

$ zig build

A Note About Versions

The Zig language is under very active development. In order to be current,
Ziglings tracks development builds of the Zig compiler rather than
versioned release builds. The last stable release was 0.7.1, but Ziglings
needs a dev build with pre-release version "0.8.0" and a build number at least
as high as that shown in the example version check above.

It is likely that you'll download a build which is greater than the minimum.

Once you have a build of the Zig compiler that works with Ziglings, they'll
continue to work together. But keep in mind that if you update one, you may
need to also update the other.

Version Changes

  • 2021-04-21 0.8.0-dev.1983 - std.fmt.format() 'any' format string
  • 2021-02-12 0.8.0-dev.1065 - std.fmt.format() 's' (string) format string

Advanced Usage

It can be handy to check just a single exercise or start from a single
exercise:

zig build 19
zig build 19_start

You can also run without checking for correctness:

zig build 19_test

Or skip the build system entirely and interact directly with the compiler
if you're into that sort of thing:

zig run exercises/001_hello.zig

Calling all wizards: To prepare an executable for debugging, install it
to zig-cache/bin with:

zig build 19_install

TODO

Contributions are very welcome! I'm writing this to teach myself and to create
the learning resource I wished for. There will be tons of room for improvement:

  • Wording of explanations
  • Idiomatic usage of Zig
  • Additional exercises

Planned exercises:

Core Language

  • Hello world (main needs to be public)
  • Importing standard library
  • Assignment
  • Arrays
  • Strings
  • If
  • While
  • For
  • Functions
  • Errors (error/try/catch/if-else-err)
  • Defer (and errdefer)
  • Switch
  • Unreachable
  • Enums
  • Structs
  • Pointers
  • Optionals
  • Struct methods
  • Slices
  • Many-item pointers
  • Unions
  • Numeric types (integers, floats)
  • Labelled blocks and loops
  • Loops as expressions
  • Builtins
  • Inline loops
  • Comptime
  • Sentinel termination
  • Quoted identifiers @""
  • Anonymous structs/tuples/lists
  • Async
  • Working with C?

Modules and the Zig Standard Library

  • Imports
  • Allocators
  • Arraylist
  • Filesystem
  • Readers and Writers
  • Formatting
  • Random Numbers
  • Crypto
  • Threads
  • Hash Maps
  • Stacks
  • Sorting
  • Iterators

The initial topics for these exercises were unabashedly cribbed from
ziglearn.org. I've since moved things around
in an order that I think best lets each topic build upon each other.

主要指标

概览
名称与所有者ratfactor/ziglings
主编程语言
编程语言Zig (语言数: 0)
平台Windows, Mac, Linux, BSD
许可证MIT License
所有者活动
创建于2021-01-03 17:17:12
推送于2024-08-21 07:12:29
最后一次提交
发布数1
最新版本名称v0.11 (发布于 )
第一版名称v0.11 (发布于 )
用户参与
星数4.3k
关注者数38
派生数479
提交数783
已启用问题?
问题数153
打开的问题数2
拉请求数178
打开的拉请求数0
关闭的拉请求数45
项目设置
已启用Wiki?
已存档?
是复刻?
已锁定?
是镜像?
是私有?