ncurses_getmaxyx

(PHP 4 >= 4.3.0, PHP 5 < 5.3.0, PECL ncurses >= 1.0.0)

ncurses_getmaxyx — Retourne la taille d'une fenêtre

Description

ncurses_getmaxyx ( resource $window , int &$y , int &$x ) : void

Avertissement

Cette fonction est EXPERIMENTALE. Le comportement de cette fonction, son nom, et toute la documentation autour de cette fonction peut changer sans préavis dans une prochaine version de PHP. Cette fonction doit être utilisée à vos risques et périls.

Place la taille verticale et la taille horizontale de la fenêtre window dans les variables fournies.

Les variables doivent être passées par référence, donc, elles seront modifiées lorsque l'utilisateur change la taille du terminal.

Liste de paramètres

window: La fenêtre mesurée
y: Sera défini pour la hauteur de la fenêtre
x: Sera défini pour la largeur de la fenêtre

Valeurs de retour

Aucune valeur n'est retournée.

add a note

User Contributed Notes 2 notes

down

vic at lfs dot net ¶

16 years ago


TIP 1: If you want to know the size of the main (default) ncurses screen, you can use the defined constant STDSCR
eg. ncurses_getmaxyx (STDSCR, $Height, $Width);
No need to create a window, get its size and delete it again (not sure if this works on php versions < 5 though).

TIP 2 : If you are creating a PHP console application and want to support terminal resizing and if you find that the ncurses screen doesn't actually resize when you resize your terminal (which was the case for me (on FreeBSD 5.3 at least)) you should end the current ncurses session and restart it again. Very easy to do this if you create your own ncurses class with a nice con- and destructor.

down

-1

superzouz at hotmail dot com ¶

17 years ago


After some headscratching as to why my script was not detecting the terminal being resized... i discovered that the function would not report the new size of the terminal until the window is refreshed.
So this is the code that I am using to get the size of the screen:

$fullscreen = ncurses_newwin ( 0, 0, 0, 0); 

// everytime you want to find out the size of the screen, write the following 2 lines:
ncurses_wrefresh($fullscreen); 
ncurses_getmaxyx ($fullscreen, $y, $x );

add a note