NAME

	Ref, incref, decref – reference counts

SYNOPSIS

	int     incref(Ref *r) int     decref(Ref *r)

DESCRIPTION

	A Ref structure holds a reference count for a data structure: typedef struct struct Ref { Lock; long ref; } Ref; The reference count proper is found in ref; the Lock prevents concurrent updates (see lock(9)). Incref atomically increments the reference count r, and returns the new count. Decref atomically decrements the reference count r, and returns the new count.

EXAMPLES

	Release a structure containing a Ref on last use. if(decref(s) == 0) free(s);

SOURCE

	/sys/src/9/port/chan.c

DIAGNOSTICS

	Decref will panic(9) if the count goes negative, revealing a reference counting bug.

Copyright © 2024 Plan 9 Foundation. All rights reserved.