The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group


syncok, wcursyncup, wsyncdown, wsyncup - synchronise a window with its parents or children


#include <curses.h>

int syncok(WINDOW *win, bool bf);

void wcursyncup(WINDOW *win);

void wsyncdown(WINDOW *win);

void wsyncup(WINDOW *win);


The syncok() function determines whether all ancestors of the specified window are implicitly touched whenever there is a change in the window. If bf is TRUE, such implicit touching occurs. If bf is FALSE, such implicit touching does not occur. The initial state is FALSE.

The wcursyncup() function updates the current cursor position of the ancestors of win to reflect the current cursor position of win.

The wsyncdown() function touches win if any ancestor window has been touched.

The wsyncup() function unconditionally touches all ancestors of win.


Upon successful completion, syncok() returns OK. Otherwise, it returns ERR.

The other functions do not return a value.


No errors are defined.


Applications seldom call wsyncdown() because it is called by all refresh operations.


doupdate(), is_linetouched(), <curses.h>.

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]