avo/examples/pragma/README.md

pragma

Apply compiler directives to avo functions.

The code generator uses the Pragma function to apply the //go:noescape directive to the Add function:

func main() {
	TEXT("Add", NOSPLIT, "func(z, x, y *uint64)")
	Pragma("noescape")
	Doc("Add adds the values at x and y and writes the result to z.")
	zptr := Mem{Base: Load(Param("z"), GP64())}
	xptr := Mem{Base: Load(Param("x"), GP64())}
	yptr := Mem{Base: Load(Param("y"), GP64())}
	x, y := GP64(), GP64()
	MOVQ(xptr, x)
	MOVQ(yptr, y)
	ADDQ(x, y)
	MOVQ(y, zptr)
	RET()
	Generate()
}

Note the directive is applied in the generated stub file:

// Add adds the values at x and y and writes the result to z.
//
//go:noescape
func