Zig 0.17.0-dev (Split by item) This is an example of documentation generated by
ZigDoc , an alternative to Zig's built-in
Auto Doc feature. See also
examples in other modes/formats . The project being documented here (as the example) is the Zig standard library.
std › Io › Threaded › dirCreateDirPosix Private Function dirCreateDirPosix Doc Source Private Function std.Io.Threaded.dirCreateDirPosix
fn dirCreateDirPosix (userdata : ?*anyopaque , dir : Dir , sub_path : []const u8 , permissions : Dir .Permissions ) Dir .CreateDirError !void Params userdata : ?*anyopaque dir : Dir sub_path : []const u8 permissions : Dir .Permissions File Io/Threaded.zig: 3340
3340
3341
3342
3343
3344
3345
3346
3347
3348
3349
3350
3351
3352
3353
3354
3355
3356
3357
3358
3359
3360
3361
3362
3363
3364
3365
3366
3367
3368
3369
3370
3371
3372
3373
3374
3375
3376
3377
3378 fn dirCreateDirPosix (userdata : ?*anyopaque , dir : Dir , sub_path : []const u8 , permissions : Dir .Permissions ) Dir .CreateDirError !void {
const t : *Threaded = @ptrCast (@alignCast (userdata ));
_ = t ;
var path_buffer : [posix .PATH_MAX ]u8 = undefined ;
const sub_path_posix = try pathToPosix (sub_path , &path_buffer );
const syscall : Syscall = try .start ();
while (true ) {
switch (posix .errno (posix .system .mkdirat (dir .handle , sub_path_posix , permissions .toMode ()))) {
.SUCCESS => {
syscall .finish ();
return ;
},
.INTR => {
try syscall .checkCancel ();
continue ;
},
.ACCES => return syscall .fail (error .AccessDenied ),
.PERM => return syscall .fail (error .PermissionDenied ),
.DQUOT => return syscall .fail (error .DiskQuota ),
.EXIST => return syscall .fail (error .PathAlreadyExists ),
.LOOP => return syscall .fail (error .SymLinkLoop ),
.MLINK => return syscall .fail (error .LinkQuotaExceeded ),
.NAMETOOLONG => return syscall .fail (error .NameTooLong ),
.NOENT => return syscall .fail (error .FileNotFound ),
.NOMEM => return syscall .fail (error .SystemResources ),
.NOSPC => return syscall .fail (error .NoSpaceLeft ),
.NOTDIR => return syscall .fail (error .NotDir ),
.ROFS => return syscall .fail (error .ReadOnlyFileSystem ),
// dragonfly: when dir_fd is unlinked from filesystem
.NOTCONN => return syscall .fail (error .FileNotFound ),
.ILSEQ => return syscall .fail (error .BadPathName ),
.BADF => |err | return syscall .errnoBug (err ), // File descriptor used after closed.
.FAULT => |err | return syscall .errnoBug (err ),
else => |err | return syscall .unexpectedErrno (err ),
}
}
}