Функция gettext() копирует текст из прямоугольника с левым верхним углом в точке left, top и с правым нижним углом в точке с координатами right, bottom. Текст копируется в буфер, на который указывает переменная buf. Координаты относятся не к окну, а к экрану.

Необходимое количество памяти для хранения области экрана вычисляется по формуле число_байт = строки * столбцы * 2. Причина, по которой необходимо умножить число столбцов на число строк и умножить это произведение на 2, заключается в том, что каждый символ, выводимый на экран, требует для хранения 2 байта: 1 байт для самого символа и 1 байт для его атрибутов.

Функция возвращает в случае успеха 1 и 0 при ошибке.