ncurses_clear

(PHP 4 >= 4.1.0, PHP 5)

ncurses_clear -- Clear screen

Description

bool ncurses_clear ( void )

警告

本函数是实验性的。本函数的行为,包括函数名称以及其它任何关于本函数的文档可能会在没有通知的情况下随 PHP 以后的发布而改变。使用本函数风险自担。

ncurses_clear() clears the screen completely without setting blanks. 如果成功则返回 TRUE,失败则返回 FALSE

Note: ncurses_clear() clears the screen without setting blanks, which have the current background rendition. To clear screen with blanks, use ncurses_erase().

See also ncurses_erase().


add a note add a note User Contributed Notes
areaz at dotgeek org
14-May-2004 06:49
When your script exits, after ncurses_clear() was called, it could leave your terminal in an inconsistent state.

Therefore, you should call ncurses_savetty() in a constructor and nurses_resetty() in a destructor, to ensure, that your terminal is working fine after your script exits.

Here is an example code snippet, on how to use this function, without falling into trouble ;-)

<? // PHP5 Example

class foo
{
  
/* Foo constructor */
  
function __construct()
   {
      
/* Initialize ncurses first */
      
ncurses_init();

      
/* Save your tty !!! */
      
ncurses_savetty();
   }

   function
bar ()
   {
      
/* Clear the screen and wait a few seconds */
      
ncurses_clear();

      
sleep(5);
   }

  
/* Foo destructor */
  
function __destruct()
   {
      
/* Restore your terminal settings */
      
ncurses_resetty();

      
/* End ncurses and clean up */
      
ncurses_end();
   }

}

$test_ncurses = new foo;
$test_ncurses->bar();
?>