screen_destroy_group()

Updated: April 19, 2023

Destroy a group

Synopsis:

#include <screen/screen.h>
int screen_destroy_group(screen_group_t grp)

Arguments:

grp
The group to be destroyed. The group must have been created with screen_create_group() or screen_create_window_group().

Library:

libscreen

Description:

Function Type: Flushing Execution

This function destroys a group given a screen_group_t instance. When a group is destroyed, all windows and pixmaps that belonged to the group are no longer associated with the group. You must destroy each screen_group_t after it's no longer needed.

Returns:

0 if successful, or -1 if an error occurred (errno is set; refer to errno.h for more details).