Index: phpdoc/fr/functions/array.xml diff -u phpdoc/fr/functions/array.xml:1.43 phpdoc/fr/functions/array.xml:1.44 --- phpdoc/fr/functions/array.xml:1.43 Sat Nov 10 16:49:49 2001 +++ phpdoc/fr/functions/array.xml Mon Nov 12 00:10:19 2001 @@ -1,5 +1,5 @@ - + Tableaux Tableaux @@ -144,6 +144,148 @@ + + + + array_chunk + Sépare un tableau en tableaux de taille inférieure + + + Description + + + array array_chunk + array input + int size + bool preserve_keys + + + + array_chunk sépare le tableau + input en plusieurs tableaux de taille + size. Il est aussi possible que le + dernier tableau ait moins de valeurs. Le résultat est un + tableau multidimensionnel, indexé numériquement. + + + En passant la valeur &true; au paramètre optionnel + preserve_keys, vous pouvez forcer + PHP à préserver les clés originales du tableau + input. Si vous utilisez la valeur + par défaut (&false;), de nouveaux index numériques seront + fournis, commencant à 0. + + + + Exemple avec <function>array_chunk</function> + +<?php +$input_array = array('a', 'b', 'c', 'd', 'e'); +print_r(array_chunk($input_array, 2)); +print_r(array_chunk($input_array, 2, TRUE)); +?> + + + L'exemple ci-dessus va afficher : + + +Array +( + [0] => Array + ( + [0] => a + [1] => b + ) + + [1] => Array + ( + [0] => c + [1] => d + ) + + [2] => Array + ( + [0] => e + ) + +) +Array +( + [0] => Array + ( + [0] => a + [1] => b + ) + + [1] => Array + ( + [2] => c + [3] => d + ) + + [2] => Array + ( + [4] => e + ) + +) + + + + + array_count_values @@ -2515,6 +2657,47 @@ + krsort Index: phpdoc/fr/functions/bc.xml diff -u phpdoc/fr/functions/bc.xml:1.6 phpdoc/fr/functions/bc.xml:1.7 --- phpdoc/fr/functions/bc.xml:1.6 Mon Jul 23 05:10:16 2001 +++ phpdoc/fr/functions/bc.xml Mon Nov 12 00:10:20 2001 @@ -1,3 +1,5 @@ + + Nombres de grande taille BC math Index: phpdoc/fr/functions/bzip2.xml diff -u phpdoc/fr/functions/bzip2.xml:1.11 phpdoc/fr/functions/bzip2.xml:1.12 --- phpdoc/fr/functions/bzip2.xml:1.11 Mon Jul 16 12:46:10 2001 +++ phpdoc/fr/functions/bzip2.xml Mon Nov 12 00:10:20 2001 @@ -1,16 +1,18 @@ + + Compression Bzip2 Bzip2 - Ce module utilise les fonctions de la librairie + Ce module utilise les fonctions de la librairie bzip2, de Julian Seward pour écrire et lire des fichier bzip2 (.bz2) de manière transparente. Le support bzip2 par PHP n'est pas activé par défaut. Vous devez utiliser l'option de configuration - + lors de la compilation de PHP pour l'activer. Ce module requiert la librairie bzip2/libbzip2, version >= 1.0.x. @@ -58,7 +60,7 @@ - bzclose ferme le fichier bzip2 + bzclose ferme le fichier bzip2 représenté par le pointeur bz. @@ -70,7 +72,7 @@ valide, et avoir été ouvert avec bzopen. - Voir aussi + Voir aussi bzopen. @@ -89,13 +91,13 @@ int blocksize - int + int workfactor - bzcompress compresse la chaîne + bzcompress compresse la chaîne source et retourne les données ainsi encodée. @@ -125,7 +127,7 @@ - Voir aussi + Voir aussi bzdecompress. @@ -147,15 +149,15 @@ - bzdecompress décompresse la chaîne + bzdecompress décompresse la chaîne source, en supposant qu'elle a été compressée avec bzip2, puis la retourne. Si le paramètre optionnel small vaut TRUE, un autre algorithme de décompression sera utilisé : il consomme - moins de mémoire (le maximum demandé tombe autour de - 2300 ko), mais fonctionne globalement à la moitié de - la vitesse. Reportez-vous à la - documentation bzip2 pour plus de + moins de mémoire (le maximum demandé tombe autour de + 2300 ko), mais fonctionne globalement à la moitié de + la vitesse. Reportez-vous à la + documentation bzip2 pour plus de détails sur cette fonctionnalité. @@ -169,7 +171,7 @@ - Voir aussi + Voir aussi bzcompress. @@ -189,12 +191,12 @@ bzerrno retourne le numéro d'erreur - du fichier bz2 représenté par le pointeur + du fichier bz2 représenté par le pointeur bz. - Voir aussi - bzerror et + Voir aussi + bzerror et bzerrstr. @@ -216,7 +218,7 @@ bzerror retourne le numéro et le message d'erreur - du fichier bz2 représenté par le pointeur + du fichier bz2 représenté par le pointeur bz. bzerror retourne un tableau associatif. @@ -233,8 +235,8 @@ - Voir aussi - bzerrno et + Voir aussi + bzerrno et bzerrstr. @@ -254,12 +256,12 @@ bzerrstr retourne le message d'erreur - du fichier bz2 représenté par le pointeur + du fichier bz2 représenté par le pointeur bz. - Voir aussi - bzerrno et + Voir aussi + bzerrno et bzerror. @@ -288,8 +290,8 @@ en cas de succès, et FALSE sinon. - Voir aussi - bzread et + Voir aussi + bzread et bzwrite. @@ -310,7 +312,7 @@ bzopen ouvre un fichier bzip2 (.bz2) - en écriture ou en lecture. filename + en écriture ou en lecture. filename est le nom du fichier à ouvrir. mode est similaire au même paramètre de la fonction fopen (`r' pour lecture, `w' pour écriture, etc.). @@ -331,7 +333,7 @@ - Voir aussi + Voir aussi bzclose. @@ -347,20 +349,20 @@ string bzread resource bz - int + int length - bzread lit jusqu'à length - octets depuis le fichier bzip2, référencé par le pointeur - bz. La lecture s'arrête lorsque - length octets (non compressés) - ont été lus, qu'une erreur est rencontrée, - ou bien que la fin du fichier a été atteinte : - le premier des trois qui survient. Si le paramètre - optionnel length est omis, + bzread lit jusqu'à length + octets depuis le fichier bzip2, référencé par le pointeur + bz. La lecture s'arrête lorsque + length octets (non compressés) + ont été lus, qu'une erreur est rencontrée, + ou bien que la fin du fichier a été atteinte : + le premier des trois qui survient. Si le paramètre + optionnel length est omis, bzread lit 1024 octets (non compressés) en même temps. @@ -377,8 +379,8 @@ - Voir aussi - bzwrite et + Voir aussi + bzwrite et bzopen. @@ -403,10 +405,10 @@ bzwrite écrit le contenu de la chaîne data dans le fichier bzip2 représenté - par bz. Si le paramètre optionnel - length est fourni, l'écriture sera - arrêtée après l'écriture de - length octets (non compressés), + par bz. Si le paramètre optionnel + length est fourni, l'écriture sera + arrêtée après l'écriture de + length octets (non compressés), ou la fin de la chaîne (le premier qui survient). @@ -418,12 +420,12 @@ $bz = bzopen("/tmp/foo.bz2", "w"); bzwrite($bz, $str, strlen($str)); ?> - + - Voir aussi - bzread et + Voir aussi + bzread et bzopen. Index: phpdoc/fr/functions/calendar.xml diff -u phpdoc/fr/functions/calendar.xml:1.5 phpdoc/fr/functions/calendar.xml:1.6 --- phpdoc/fr/functions/calendar.xml:1.5 Sat Jul 7 18:22:02 2001 +++ phpdoc/fr/functions/calendar.xml Mon Nov 12 00:10:20 2001 @@ -1,543 +1 @@ - - Calendrier - Calendrier - - - Les fonctions de calendrier ne sont disponibles que si - l'extension calendrier a été compilée. - Elle est située dans les sous-dossiers "dl" ou "ext" - de votre distribution de PHP. Lisez le fichier - README pour plus de détails. - - - L'extension de calendrier propose une série de fonctions - qui simplifie les conversions entre les différents formats - de calendrier. La référence est le nombre de jour du - calendrier Julien. C'est le nombre de jours depuis une date qui - commence bien au delà des dates les plus reculées - dont on a besoin (située en 4000 avant J.C.). Pour convertir - une date d'un calendrier à un autre, il faut d'abord la convertir - dans ce calendrier, puis convertir le résultat dans le calendrier - désiré. Attention, le nombre de jour du calendrier Julien - est un système très différent du calendrier Julien!. - Pour plus d'informations (en anglais), reportez vous à - &url.calendar;. - Les traductions issues de ces pages seront mises entre guillemets. - - - - - JDToGregorian - - Convertit le nombre de jours du calendrier Julien en date grégorienne. - - - - Description - - string jdtogregorian - int julianday - - - jdtogregorian convertit le nombre de jours du - calendrier Julien en une chaîne contenant une date du calendrier - grégorien, au format "mois/jour/année". - - - - - - GregorianToJD - - Convertit une date grégorienne en nombre de jours du calendrier julien. - - - - Description - - int gregoriantojd - int month - int day - int year - - - Intervalle de validité pour le calendrier grégorien : - 4714 avant JC à 9999 après JC.A.D. - - - Bien qu'il soit possible de manipuler des dates jusqu'en 4714 avant JC, - une telle utilisation n'est pas significative. En effet, ce calendrier fut - créé le 18 octobre 1582 après J.C. (ou 5 octobre 1582 - en calendrier grec). Certains pays ne l'acceptèrent que bien plus - tard. Par exemple, les britanniques n'y passèrent en 1752, les - Russes en 1918 et les Grecs en 1923. La plus part des pays européens - utilisaient le calendrier Julien avant le Grégorien. - - Fonctions calendrier - -<?php -$jd = gregoriantojd(10,11,1970); -echo("$jd\n"); -$gregorian = jdtogregorian($jd); -echo("$gregorian\n"); -?> - - - - - - - - JDToJulian - - Convertit le nombre de jours du calendrier Julien en date du calendrier - Julien. - - - - Description - - string jdtojulian - int julianday - - - jdtojulian convertit le nombre de jours du calendrier - Julien en une chaîne contenant la date du calendrier Julien, au format - "mois/jour/année". - - - - - - JulianToJD - - Convertit le nombre de jour du calendrier Julien en date du calendrier - Julien. - - - - Description - - int juliantojd - int month - int day - int year - - - Intervalle de validité du calendrier Julien : 4713 avant JC à - 9999 après J.C.. - - - Bien qu'il soit possible de manipuler des dates jusqu'en 4713 avant JC, - une telle utilisation n'est pas significative. En effet, ce calendrier fut - créé en 46 avant JC, et ses détails ne furent - finalisés qu'au plus tôt en 8 après JC, et probablement - pas avant le 4ème siècle après JC. De plus, le - début de l'année variait suivant les peuples, certains - n'acceptant pas janvier comme premier mois de l'année. - - - - - - JDToJewish - - Convertit le nombre de jours du calendrier julien en date du calendrier - juif. - - - - Description - - string jdtojewish - int julianday - - - jdtojewish convertit le nombre de jours du calendrier - julien en date du calendrier juif. - - - - - - JewishToJD - - Convertit une date du calendrier juif en nombre de jours du calendrier julien. - - - - Description - - int jewishtojd - int month - int day - int year - - - Bien qu'il soit possible de manipuler des dates à partir de l'an 1 (3761 - avant JC), une telle utilisation a peu de sens. - - - Le calendrier juif a été utilisé depuis plusieurs - dizaines de siècles, mais dans les premiers temps, il n'y avait - pas de formule pour déterminer le début du mois. Un nouveau - mois commencait quand une nouvelle lune était observée. - - - - - - JDToFrench - - Convertit le nombre de jours du calendrier julien en date du calendrier - français républicain - - - - Description - - string jdtofrench - int juliandaycount - - - jdtofrench convertit le nombre de jours du calendrier - julien en date du calendrier français républicain. - - - - - - FrenchToJD - - Convertit une date du calendrier français républicain en nombre - de jours du calendrier julien. - - - - Description - - int frenchtojd - int month - int day - int year - - - frenchtojd convertit une date du calendrier - français républicain en nombre de jour du calendrier julien. - - - Ces fonctions convertissent les dates comprises entre l'an 1 et l'an 14 - (22 September 1792 à 22 September 1806 en calendrier grégorien). - Cela couvre plus que la durée d'existence de ce calendrier. - - - - - - JDMonthName - Retourne le nom du mois. - - - Description - - string jdmonthname - int julianday - int mode - - - jdmonthname retourne une chaîne contenant le - nom du mois. mode indique de quel calendrier - dépend ce mois, et quel type de nom doit être retourné. -

- Modes de calendrier - - - - Mode - Signification - - - - - 0 - Grégorien - abrégé - - - 1 - Grégorien - - - 2 - Julien - abrégé - - - 3 - Julien - - - 4 - Juif - - - 5 - Républicain français - - - -
- - - - - - JDDayOfWeek - - Retourne le numéro du jour de la semaine. - - - - Description - - mixed jddayofweek - int julianday - int mode - - - jddayofweek retourne le numéro du jour de - la semaine. Peut retourner une chaîne ou un entier, en fonction - du mode. - - Modes - - - - Mode - Signification - - - - - 0 - Retourne le numéro du jour comme un entier - (0=dimanche, 1=lundi, etc.) - - - - 1 - Retourne une chaîne contenant le nom du jour - (anglais grégorien) - - - - 2 - Retourne une chaîne contenant le nom abrégé du - jour de la semaine (anglais grégorien). - - - - -
-
-
-
- - - easter_date - - Retourne un timestamp UNIX pour Pàques, à minuit, pour une - année donnée. - - - - Description - - int easter_date - int year - - - easter_date retourne un timestamp UNIX pour Pàques, - à minuit, pour une année donnée. Si l'année n'est - pas précisée, c'est l'année en cours qui est - utilisée. - - - ATTENTION: easter_date - génére une alerte (Warning) si la date tombe hors de la - zone de validité des timestamp UNIX (i.e. avant 1970 ou - après 2037). - - Exemples avec <function>easter_date</function> - -echo date( "M-d-Y", easter_date(1999) ); /* "04 avril 1999" */ -echo date( "M-d-Y", easter_date(2000) ); /* "23 avril 2000" */ -echo date( "M-d-Y", easter_date(2001) ); /* "15 avril 2001" */ - - - - - La date de Pàques a été fixée par le concile - de Nicée, en 325 de notre ère, comme étant le dimanche - après la première lune pleine qui suit l'équinoxe de - printemps. L'équinoxe de printemps est considéré - comme étant toujours le 21 mars, ce qui réduit le - problème au calcul de la date de la lune pleine qui suit, et le - dimanche suivant. L'algorithme fut introduit vers 532, par Dionysius - Exiguus. Avec le calendrier Julien, (pour les années avant 1753), - un cycle de 19 ans suffit pour connaître les date des phases de la - lune. Avec le calendrier grégorien, (à partir des années - 1753, concu par Clavius et Lilius, puis introduit par le pape Gregoire XIII - en Octobre 1582, et en Grande Bretagne et ses colonies en septembre 1752), - deux facteurs de corrections ont été ajoutés pour rendre - le cycle plus précis. - - - (Ce code est basé sur le programme en C de Simon Kershaw, - <webmaster <email protected>>) - - - Voir easter_days pour les calculs de date de - Pàques avant 1970 et apres 2037. - - - - - - easter_days - - Retourne le nombre de jour entre le 21 Mars et Pàques, pour une - année donnée. - - - - Description - - int easter_days - int year - - - easter_days retourne le nombre de jour entre le 21 Mars - et Pàques, pour une année donnée. Si l'année n'est - pas précisée, l'année en cours est utilisée par - défaut. - - - easter_days peut être utilisée à - la place de easter_date pour calculer la date de - Pàques, pour les années qui tombent hors de l'intervalle - de validité des timestamps UNIX (i.e. avant 1970 ou après 2037). - - Exemple avec <function>easter_days</function> - -<?php -echo easter_days(1999); /* 14, i.e. 4 Avril */ -echo easter_days(1492); /* 32, i.e. 22 Avril */ -echo easter_days(1913); /* 2, i.e. 23 Mars */ -?> - - - - - La date de Pàques a été fixée par le concile - de Nicée, en 325 de notre ère, comme étant le dimanche - après la première lune pleine qui suit l'équinoxe de - printemps. L'équinoxe de printemps est considéré - comme étant toujours le 21 mars, ce qui réduit le - problème au calcul de la date de la lune pleine qui suit, et le - dimanche suivant. L'algorithme fut introduit vers 532, par Dionysius - Exiguus. Avec le calendrier Julien, (pour les années avant 1753), - un cycle de 19 ans suffit pour connaître les date des phases de la - lune. Avec le calendrier grégorien, (à partir des années - 1753, concu par Clavius et Lilius, puis introduit par le pape Gregoire XIII - en Octobre 1582, et en Grande Bretagne et ses colonies en septembre 1752), - deux facteurs de corrections ont été ajoutés pour rendre - le cycle plus précis. - - - (Ce code est basé sur le programme en C de Simon Kershaw, - <webmaster <email protected>>) - - - Voir aussi easter_date. - - - - - - unixtojd - Convertit un timestamp UNIX en nombre de jours Julien - - - Description - - - int unixtojd - int - timestamp - - - - - unixtojd retourne le nombre de jours juliens du - timestamp UNIX timestamp (nombre de secondes - depuis le 1/1/1970), ou pour le jour courant si - timestamp est omis. - - - Voir aussi jdtounix. - - - - unixtojd n'est disponible qu'à partir de la - version PHP 4.0RC1. - - - - - - - jdtounix - Convertit un nombre de jour Julien en timestamp UNIX - - - Description - - - int jdtounix - int jday - - - - jdtounix retourne un timestamp UNIX - correspondant au nombre de jour julien jday - ou &false; si jday n'est pas dans l'intervalle de - validité de l'époque UNIX. (années grégorienne - entre 1970 et 2037 ou 2440588 <= jday <= 2465342 ). - - - Voir aussi jdtounix. - - - - jdtounix n'est disponible qu'à partir de la - version PHP 4.0RC1. - - - - - - + Calendrier Calendrier Les fonctions de calendrier ne sont disponibles que si l'extension calendrier a été compilée. Elle est située dans les sous-dossiers "dl" ou "ext" de votre distribution de PHP. Lisez le fichier README pour plus de détails. L'extension de calendrier propose une série de fonctions qui simplifient les conversions entre les différents formats de calendrier. La référence est le nombre de jours du calendrier Julien. C'est le nombre de jours depuis une date qui commence bien au-delà des dates les plus reculées dont on a besoin (située en 4000 avant J.C.). Pour convertir une date d'un calendrier à un autre, il faut d'abord la convertir dans ce calendrier, puis convertir le résultat dans le calendrier désiré. Attention, le nombre de jours du calendrier Julien est un système très différent du calendrier Julien!. Pour plus d'informations (en anglais), reportez-vous à &url.calendar;. Les traductions issues de ces pages seront mises entre guillemets. JDToGregorian Convertit le nombre de jours du calendrier Julien en date grégorienne. Description string jdtogregorian int julianday jdtogregorian convertit le nombre de jours du calendrier Julien en une chaîne contenant une date du calendrier grégorien, au format "mois/jour/année". GregorianToJD Convertit une date grégorienne en nombre de jours du calendrier Julien. Description int gregoriantojd int month int day int year Intervalle de validité pour le calendrier grégorien : 4714 avant JC à 9999 après JC.A.D. Bien qu'il soit possible de manipuler des dates jusqu'en 4714 avant JC, une telle utilisation n'est pas significative. En effet, ce calendrier fut créé le 18 octobre 1582 après J.C. (ou 5 octobre 1582 en calendrier grec). Certains pays ne l'acceptèrent que bien plus tard. Par exemple, les britanniques n'y passèrent en 1752, les Russes en 1918 et les Grecs en 1923. La plupart des pays européens utilisaient le calendrier Julien avant le Grégorien. Fonctions calendrier <?php$jd = gregoriantojd(10,11,1970);echo("$jd\n");$gregorian = jdtogregorian($jd);echo("$gregorian\n");?> JDToJulian Convertit le nombre de jours du calendrier Julien en date du calendrier Julien. Description string jdtojulian int julianday jdtojulian convertit le nombre de jours du calendrier Julien en une chaîne contenant la date du calendrier Julien, au format "mois/jour/année". JulianToJD Convertit le nombre de jours du calendrier Julien en date du calendrier Julien. Description int juliantojd int month int day int year Intervalle de validité du calendrier Julien : 4713 avant JC à 9999 après J.C.. Bien qu'il soit possible de manipuler des dates jusqu'en 4713 avant JC, une telle utilisation n'est pas significative. En effet, ce calendrier fut créé en 46 avant JC, et ses détails ne furent finalisés qu'au plus tôt en 8 après JC, et probablement pas avant le 4ème siècle après JC. De plus, le début de l'année variait suivant les peuples, certains n'acceptant pas janvier comme premier mois de l'année. JDToJewish Convertit le nombre de jours du calendrier Julien en date du calendrier juif. Description string jdtojewish int julianday jdtojewish convertit le nombre de jours du calendrier Julien en date du calendrier juif. JewishToJD Convertit une date du calendrier juif en nombre de jours du calendrier Julien. Description int jewishtojd int month int day int year Bien qu'il soit possible de manipuler des dates à partir de l'an 1 (3761 avant JC), une telle utilisation a peu de sens. Le calendrier juif a été utilisé depuis plusieurs dizaines de siècles, mais dans les premiers temps, il n'y avait pas de formule pour déterminer le début du mois. Un nouveau mois commencait quand une nouvelle lune était observée. JDToFrench Convertit le nombre de jours du calendrier Julien en date du calendrier français républicain Description string jdtofrench int juliandaycount jdtofrench convertit le nombre de jours du calendrier julien en date du calendrier français républicain. FrenchToJD Convertit une date du calendrier français républicain en nombre de jours du calendrier Julien. Description int frenchtojd int month int day int year frenchtojd convertit une date du calendrier français républicain en nombre de jours du calendrier Julien. Ces fonctions convertissent les dates comprises entre l'an 1 et l'an 14 (22 September 1792 à 22 September 1806 en calendrier grégorien). Cela couvre plus que la durée d'existence de ce calendrier. JDMonthName Retourne le nom du mois. Description string jdmonthname int julianday int mode jdmonthname retourne une chaîne contenant le nom du mois. mode indique de quel calendrier dépend ce mois, et quel type de nom doit être retourné. Modes de calendrier Mode Signification 0 Grégorien - abrégé 1 Grégorien 2 Julien - abrégé 3 Julien 4 Juif 5 Républicain français
JDDayOfWeek Retourne le numéro du jour de la semaine. Description mixed jddayofweek int julianday int mode jddayofweek retourne le numéro du jour de la semaine. Peut retourner une chaîne ou un entier, en fonction du mode. Modes Mode Signification 0 Retourne le numéro du jour comme un entier (0=dimanche, 1=lundi, etc.) 1 Retourne une chaîne contenant le nom du jour (anglais grégorien) 2 Retourne une chaîne contenant le nom abrégé du jour de la semaine (anglais grégorien).
easter_date Retourne un timestamp UNIX pour Pâques, à minuit Description int easter_date int year easter_date retourne un timestamp UNIX pour Pâques, à minuit, pour une année donnée. Si l'année n'est pas précisée, c'est l'année en cours qui est utilisée. ATTENTION: easter_date génère une alerte (Warning) si la date tombe hors de la zone de validité des timestamp UNIX (i.e. avant 1970 ou après 2037). Exemples avec <function>easter_date</function> echo date( "M-d-Y", easter_date(1999) ); /* "04 avril 1999" */echo date( "M-d-Y", easter_date(2000) ); /* "23 avril 2000" */echo date( "M-d-Y", easter_date(2001) ); /* "15 avril 2001" */ La date de Pâques a été fixée par le concile de Nicée, en 325 de notre ère, comme étant le dimanche après la première pleine lune qui suit l'équinoxe de printemps. L'équinoxe de printemps est considéré comme étant toujours le 21 mars, ce qui réduit le problème au calcul de la date de la lune pleine qui suit, et le dimanche suivant. L'algorithme fut introduit vers 532, par Dionysius Exiguus. Avec le calendrier Julien, (pour les années avant 1753), un cycle de 19 ans suffit pour connaître les date des phases de la lune. Avec le calendrier grégorien, (à partir des années 1753, conçu par Clavius et Lilius, puis introduit par le pape Grégoire XIII en octobre 1582, et en Grande Bretagne et ses colonies en septembre 1752), deux facteurs de corrections ont été ajoutés pour rendre le cycle plus précis. (Ce code est basé sur le programme en C de Simon Kershaw, <webmaster@ely.anglican.org>) Voir easter_days pour les calculs de date de Pâques avant 1970 et après 2037. easter_days Retourne le nombre de jours entre le 21 Mars et Pâques, pour une année donnée. Description int easter_days int year easter_days retourne le nombre de jours entre le 21 Mars et Pâques, pour une année donnée. Si l'année n'est pas précisée, l'année en cours est utilisée par défaut. easter_days peut être utilisée à la place de easter_date pour calculer la date de Pâques, pour les années qui tombent hors de l'intervalle de validité des timestamps UNIX (i.e. avant 1970 ou après 2037). Exemple avec <function>easter_days</function> <?php echo easter_days(1999); /* 14, i.e. 4 Avril */ echo easter_days(1492); /* 32, i.e. 22 Avril */ echo easter_days(1913); /* 2, i.e. 23 Mars */?> La date de Pâques a été fixée par le concile de Nicée, en 325 de notre ère, comme étant le dimanche après la première pleine lune qui suit l'équinoxe de printemps. L'équinoxe de printemps est considéré comme étant toujours le 21 mars, ce qui réduit le problème au calcul de la date de la lune pleine qui suit, et le dimanche suivant. L'algorithme fut introduit vers 532, par Dionysius Exiguus. Avec le calendrier Julien, (pour les années avant 1753), un cycle de 19 ans suffit pour connaître les date des phases de la lune. Avec le calendrier grégorien, (à partir des années 1753, conçu par Clavius et Lilius, puis introduit par le pape Grégoire XIII en octobre 1582, et en Grande Bretagne et ses colonies en septembre 1752), deux facteurs de corrections ont été ajoutés pour rendre le cycle plus précis. (Ce code est basé sur le programme en C de Simon Kershaw, <webmaster@ely.anglican.org>) Voir aussi easter_date. unixtojd Convertit un timestamp UNIX en nombre de jours Julien Description int unixtojd int timestamp unixtojd retourne le nombre de jours Juliens du timestamp UNIX timestamp (nombre de secondes depuis le 1/1/1970), ou pour le jour courant si timestamp est omis. Voir aussi jdtounix. unixtojd n'est disponible qu'à partir de la version PHP 4.0RC1. Voir aussi easter_date. jdtounix Convertit un nombre de jours Julien en timestamp UNIX Description int jdtounix int jday jdtounix retourne un timestamp UNIX correspondant au nombre de jours Julien jday ou FALSE si jday n'est pas dans l'intervalle de validité de l'époque UNIX. (années grégoriennes entre 1970 et 2037 ou 2440588 <= jday <= 2465342 ). Voir aussi jdtounix. jdtounix n'est disponible qu'à partir de la version PHP 4.0RC1.
\ No newline at end of file Index: phpdoc/fr/functions/ccvs.xml diff -u phpdoc/fr/functions/ccvs.xml:1.6 phpdoc/fr/functions/ccvs.xml:1.7 --- phpdoc/fr/functions/ccvs.xml:1.6 Tue Mar 6 15:50:06 2001 +++ phpdoc/fr/functions/ccvs.xml Mon Nov 12 00:10:20 2001 @@ -1,3 +1,5 @@ + + - - Paiement CCVS - CCVS - - - Ces fonctions font l'interface avec les API CCVS, vous permettant - de travailler directement avec CCVS depuis vos scripts PHP. - CCVS est la solution apportée par RedHat - au problème de l'intermediaire, lors du traitement de transactions - de cartes de crédit. Il vous permet travailler directment avec - les maisons de crédits, via votre boîte *nix et un modem. En utilisant - le module CCVS pour PHP, vous pouvez effectuer des transactions - avec les cartes de crédits, directement depuis vos scripts PHP via - CCVS. La suite vous montrera comment procéder. - - - Pour activer le support CCVS de PHP, commencez par vérifier votre - installation CCVS. Vous devez configurer PHP avec l'option . Si vous utilisez cette - option sans spécifier le chemin de votre installation, PHP essaiera - de la trouver à sa position par défaut (/usr/local/ccvs). Si CCVS est - installé dans un autre dossier, lancez la configuration avec : - , où $ccvs_path - est le chemin de votre installation CCVS. Notez bien que CCVS requiert - que $ccvs_path/lib et $ccvs_path/include existent, et qu'ils contiennent - respectivement cv_api.h et libccvs.a sous include et lib. - - - De plus, un démon ccvsd doit être disponible sur votre configuration, - et qu'il soit accessible à vos scripts PHP. Assurez vous aussi que - l'utilisateur qui exécute les scripts PHP est le même que celui qui - a installé CCVS (i.e. si vous avez installé CCVS avec l'utilisateur 'ccvs', - vos scripts PHP doivent tourner aussi en 'ccvs'). - - - Plus de détails sur CCVS sont disponibles à &url.redhat.ccvs;. - - - Cette documentation est en chantier. Jusqu'à sa finalisation, RedHat - entretient une version légèrement démodée - mais bien pratique à - &url.redhat.support;. - - - - - - - - - - - - - - - - - - - - - + + Paiement CCVS + CCVS + + + Ces fonctions font l'interface avec les API CCVS, vous permettant + de travailler directement avec CCVS depuis vos scripts PHP. + CCVS est la solution apportée par RedHat + au problème de l'intermédiaire, lors du traitement de transactions + de cartes de crédit. Il vous permet travailler directement avec + les maisons de crédits, via votre boîte *nix et un modem. En utilisant + le module CCVS pour PHP, vous pouvez effectuer des transactions + avec les cartes de crédits, directement depuis vos scripts PHP via + CCVS. La suite vous montrera comment procéder. + + + Pour activer le support CCVS de PHP, commencez par vérifier votre + installation CCVS. Vous devez configurer PHP avec l'option + . + Si vous utilisez cette + option sans spécifier le chemin de votre installation, PHP essaiera + de la trouver à sa position par défaut (/usr/local/ccvs). Si CCVS est + installé dans un autre dossier, lancez la configuration avec : + , + où $ccvs_path est le chemin de votre installation CCVS. + Notez bien que CCVS requiert + que $ccvs_path/lib et $ccvs_path/include + existent, et qu'ils contiennent respectivement + cv_api.h et libccvs.a sous + include et lib. + + + De plus, un démon ccvsd doit être disponible sur votre configuration, + et qu'il soit accessible à vos scripts PHP. Assurez-vous aussi que + l'utilisateur qui exécute les scripts PHP est le même que celui qui + a installé CCVS (i.e. si vous avez installé CCVS avec l'utilisateur 'ccvs', + vos scripts PHP doivent tourner aussi en 'ccvs'). + + + Plus de détails sur CCVS sont disponibles à &url.redhat.ccvs;. + + + Cette documentation est en chantier. Jusqu'à sa finalisation, RedHat + entretient une version légèrement démodée + mais bien pratique à + &url.redhat.support;. + + + + + + + + + + + + + + + + + + + Objets Classes et Objets Introduction About Ces fonctions permettent de gérer les classes et les objets. Vous pouvez notamment connaître le nom de la classe d'un objet, ses membres et ses méthodes, et tous les objets parents (les classes qui sont étendues par la classe d'un objet). Exemple d'utilisation Dans cet exemple, on définit une classe de base, et une extension. La classe de base définit un légume, s'il est mangeable ou pas, et sa couleur. La sous-classe epinard ajoute une méthode pour le cuisiner, et une autre pour savoir s'il est cuisiné. classes.inc <?php// classe de base, avec ses membres et ses méthodesclass Legume { var $mangeable; var $couleur; function legume( $mangeable, $couleur="green" ) { $this->mangeable = $mangeable; $this->couleur = $couleur; } function est_mangeable() { return $this->mangeable; } function quelle_couleur() { return $this->couleur; }} // fin de la classe Legume// extend la classe de baseclass Epinard extends Legume { var $cuit = FALSE; function Epinard() { $this->Legume( TRUE, "green" ); } function cuisine() { $this->cuit = TRUE; } function est_cuit() { return $this->cuit; }} // fin de la classe Epinard?> Lorsqu'on instantie deux objets de ces classes, et qu'on affiche leurs informations, on affiche aussi leur héritage. On définit ici des utilitaires qui servent essentiellement à afficher ces informations proprement. test_script.php <pre><?php include "classes.inc";// utilitaires function print_vars($obj) { $arr = get_object_vars($obj); while (list($prop, $val) = each($arr)) echo "\t$prop = $val\n"; } function print_methods($obj) { $arr = get_class_methods(get_class($obj)); foreach ($arr as $method) echo "\tfunction $method()\n"; } function class_parentage($obj, $class) { global $$obj; if (is_subclass_of($$obj, $class)) { echo "L'objet $obj belongs to class ".get_class($$obj); echo " est une sous-classe de $class\n"; } else { echo "L'objet $obj n'est pas une sous classe $class\n"; } }// instantie 2 objets $legume = new Legume(TRUE,"blue"); $feuilles = new Epinard();// affiche les informations sur ces objets echo "legume: CLASS ".get_class($legume)."\n"; echo "feuilles: CLASS ".get_class($feuilles); echo ", PARENT ".get_parent_class($feuilles)."\n";// affiche les propriétés du légume echo "\nlégume: Propriétés \n"; print_vars($legume);// et les méthodes de "feuilles" echo "\nfeuilles: Methods\n"; print_methods($feuilles); echo "\nParentée:\n"; class_parentage("feuilles", "Epinard"); class_parentage("feuilles", "Legume");?></pre> Il est important de noter que dans les exemples ci-dessus, les objets $feuilles sont une instance de Epinard qui est une sous-classe de Legume, donc la dernière partie du script va afficher : [...] Parentée: L'objet feuilles n'est pas une sous classe Spinach L'objet feuilles est une sous-classe de Legume call_user_method Appelle une méthode utilisateur d'un objet Description mixed call_user_method string method_name object obj mixed parameter mixed ... Appelle la méthode method_name depuis l'objet obj. Un exemple d'utilisation de cet objet est présenté ci-dessous, où une classe est définie, puis instantiée. On utilise alors call_user_method pour appeler indirectement les méthodes print_info. <?phpclass Pays { var $NOM; var $TLD; function Pays($nom, $tld) { $this->NOM = $nom; $this->TLD = $tld; } function print_info($prestr="") { echo $prestr."Pays: ".$this->NOM."\n"; echo $prestr."Nom de domaine: ".$this->TLD."\n"; }}$unPays = new Pays("Pérou","pe");echo "* Appel de la méthode directement\n";$unPays->print_info();echo "\n* Appel de la méthode indirectement\n";call_user_method ("print_info", $unPays, "\t");?> Voir aussi call_user_func_array. call_user_func et call_user_method_array. call_user_method_array Appelle une méthode utilisateur avec un tableau de paramètres Description mixed call_user_method_array string method_name object obj array paramarr call_user_method_array appelle la méthode method_name de l'object obj, en utilisant les paramètres paramarr, rassemblés sous forme de tableau. Voir aussi call_user_func_array, call_user_func et call_user_method. call_user_method_array a été ajoutée en version PHP 4.05. class_exists Vérifie qu'une classe a été définie Description boolean class_exists string class_name class_exists retourne TRUE si la classe class_name a été définie, et FALSE sinon. get_class Retourne la classe d'un objet Description string get_class object obj get_class retourne la classe de l'objet obj. Voir aussi get_parent_class et is_subclass_of get_class_methods Retourne les noms des méthodes d'une classe. Description array get_class_methods string class_name get_class_methods retourne un tableau contenant les noms des méthodes de la classe class_name. A partir de PHP 4.0.6, vous pouvez spécifier l'objet lui-même, au lieu de sa classe class_name. Par exemple : <?php $class_methods = get_class_methods($my_class);?> Exemple avec <function>get_class_methods</function> <?phpclass myclass { // constructeur function maclasse() { return(TRUE); } // méthode 1 function myfunc1() { return(TRUE); } // méthode 2 function mafunc2() { return(TRUE); }}$ma_classe = new maclasse();$class_methods = get_class_methods(get_class($ma_class));foreach ($class_methods as $method_name) { echo "$method_name\n";}?> Va afficher : maclassmafunc1mafunc2 Voir aussi get_class_vars et get_object_vars get_class_vars Retourne les valeurs par défaut des attributs d'une classe. Description array get_class_vars string class_name get_class_vars retourne un tableau contenant les valeurs par défaut des attributs de la classe class_name. Les variables de classe qui ne sont pas encore initialisées ne seront pas retournées par get_class_vars. Exemple <function>get_class_vars</function> <?phpclass maclasse { var $var1; // Pas de valeur par défaut var $var2 = "xyz"; var $var3 = 100; // constructeur function maclasse() { return(TRUE); }}$ma_classe = new maclasse();$class_vars = get_class_vars(get_class($ma_classe));foreach ($class_vars as $name => $value) { echo "$name : $value\n";}?> va afficher : var2 : xyzvar3 : 100 get_declared_classes Liste toutes les classes définies Description array get_declared_classes void get_declared_classes retourne un tableau contenant la liste des fonctions déclarées dans le script courant. En PHP 4.0.1pl2, trois classes supplémentaires sont retournées, au début de ce tableau : stdClass (définie dans Zend/zend.c), OverloadedTestClass (définie dans ext/standard/basic_functions.c) et Directory (définie dans ext/standard/dir.c). get_object_vars Retourne un tableau associatif des propriétés d'un objet Description array get_object_vars object obj get