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 › dirRealPathFileWindows Private Function dirRealPathFileWindows Doc Source Private Function std.Io.Threaded.dirRealPathFileWindows
fn dirRealPathFileWindows (userdata : ?*anyopaque , dir : Dir , sub_path : []const u8 , out_buffer : []u8 ) Dir .RealPathFileError !usize Params userdata : ?*anyopaque dir : Dir sub_path : []const u8 out_buffer : []u8 File Io/Threaded.zig: 6303
6303
6304
6305
6306
6307
6308
6309
6310
6311
6312
6313
6314
6315
6316
6317
6318
6319
6320
6321
6322
6323
6324
6325
6326
6327
6328
6329
6330 fn dirRealPathFileWindows (userdata : ?*anyopaque , dir : Dir , sub_path : []const u8 , out_buffer : []u8 ) Dir .RealPathFileError !usize {
const t : *Threaded = @ptrCast (@alignCast (userdata ));
_ = t ;
var path_name_w = try sliceToPrefixedFileW (dir .handle , sub_path , .{});
const h_file = handle : {
if (OpenFile (path_name_w .span (), .{
.dir = dir .handle ,
.access_mask = .{
.GENERIC = .{ .READ = true },
.STANDARD = .{ .SYNCHRONIZE = true },
},
.creation = .OPEN ,
.filter = .any ,
})) |handle | {
break :handle handle ;
} else |err | switch (err ) {
error .WouldBlock => unreachable ,
else => |e | return e ,
}
};
defer windows .CloseHandle (h_file );
// We can re-use the path buffer for the WTF-16 representation since
// we don't need the prefixed path anymore
return realPathWindowsBuf (h_file , out_buffer , &path_name_w .data );
}