Zig 0.17.0-dev (Split by item)

?

× Shortcut keys

?: Show these tips

S: Focus search field

Esc: Clear focus & close tips

U: Jump to source code

↑: Move up in search results

↓: Move down in search results

↵: Go to active search result

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. Private Function

emitDbgStmtForceCurrentIndex

Doc Source

Private Function

std.zig.AstGen.emitDbgStmtForceCurrentIndex

fn emitDbgStmtForceCurrentIndex(gz: *GenZir, lc: LineColumn) !void

In some cases, Sema expects us to generate a dbg_stmt at the instruction index directly preceding the next instruction (e.g. if a call is %10, it expects a dbg_stmt at %9). TODO: this logic may allow redundant dbg_stmt instructions; fix up Sema so we don't need it!

Params

gz: *GenZir
lc: LineColumn

File

zig/AstGen.zig:13285

fn emitDbgStmtForceCurrentIndex(gz: *GenZir, lc: LineColumn) !void {
    const astgen = gz.astgen;
    if (gz.instructions.items.len > gz.instructions_top and
        @backingInt(gz.instructions.items[gz.instructions.items.len - 1]) == astgen.instructions.len - 1)
    {
        const last = astgen.instructions.len - 1;
        if (astgen.instructions.items(.tag)[last] == .dbg_stmt) {
            astgen.instructions.items(.data)[last].dbg_stmt = .{
                .line = lc[0],
                .column = lc[1],
            };
            return;
        }
    }

    _ = try gz.add(.{ .tag = .dbg_stmt, .data = .{
        .dbg_stmt = .{
            .line = lc[0],
            .column = lc[1],
        },
    } });
}