Contribution 10211441

Catadanna · Catadanna · commit 0f231c4c3814 · 2020-10-21T14:41:33.000+02:00
diff --git a/extending/extending.po b/extending/extending.po
@@ -6,7 +6,7 @@ msgstr ""
 "Project-Id-Version: Python 3\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2020-08-24 09:01+0200\n"
-"PO-Revision-Date: 2020-10-02 15:06+0200\n"
+"PO-Revision-Date: 2020-10-21 14:39+0200\n"
 "Last-Translator: Julien Palard <julien@palard.fr>\n"
 "Language-Team: FRENCH <traductions@lists.afpy.org>\n"
 "Language: fr\n"
@@ -71,9 +71,9 @@ msgstr ""
 "et ainsi préserver la portabilité vers d'autres implémentations. Par "
 "exemple, si vous devez appeler une fonction de la bibliothèque C ou faire un "
 "appel système, vous devriez envisager d'utiliser le module :mod:`ctypes` ou "
-"d'utiliser la bibliothèque `cffi <https://cffi.readthedocs.io/>`_ plutôt que "
-"d'écrire du code C sur mesure. Ces modules vous permettent d'écrire du code "
-"Python s'interfaçant avec le code C et sont plus portables entre les "
+"d'utiliser la bibliothèque `*cffi* <https://cffi.readthedocs.io/>`_ plutôt "
+"que d'écrire du code C sur mesure. Ces modules vous permettent d'écrire du "
+"code Python s'interfaçant avec le code C et sont plus portables entre les "
 "implémentations de Python que l'écriture et la compilation d'une d'extension "
 "C."
 
@@ -309,6 +309,7 @@ msgstr ""
 "de le déterminer à partir de la valeur renvoyée."
 
 #: extending/extending.rst:160
+#, fuzzy
 msgid ""
 "When a function *f* that calls another function *g* detects that the latter "
 "fails, *f* should itself return an error value (usually ``NULL`` or "
@@ -667,12 +668,11 @@ msgstr ""
 "`PyModule_Create`, qui renvoie un objet module, et insère des objets "
 "fonction intégrés dans le module nouvellement créé en se basant sur la table "
 "(un tableau de structures :c:type:`PyMethodDef`) trouvée dans la définition "
-"du module. :c:func:`PyModule_Create` renvoie un pointeur vers l'objet "
-"module qu'il crée. Il peut s'interrompre avec une erreur fatale pour "
-"certaines erreurs, ou renvoyer ``NULL`` si le module n'a pas pu être "
-"initialisé de manière satisfaisante. La fonction `init` doit renvoyer "
-"l'objet module à son appelant, afin qu'il soit ensuite inséré dans ``sys."
-"modules``."
+"du module. :c:func:`PyModule_Create` renvoie un pointeur vers l'objet module "
+"qu'il crée. Il peut s'interrompre avec une erreur fatale pour certaines "
+"erreurs, ou renvoyer ``NULL`` si le module n'a pas pu être initialisé de "
+"manière satisfaisante. La fonction `*init* doit renvoyer l'objet module à "
+"son appelant, afin qu'il soit ensuite inséré dans ``sys.modules``."
 
 #: extending/extending.rst:383
 msgid ""
@@ -884,6 +884,16 @@ msgid ""
 "simplest way to do this is to call :c:func:`Py_BuildValue`.  For example, if "
 "you want to pass an integral event code, you might use the following code::"
 msgstr ""
+"Selon l'interface souhaitée pour la fonction de rappel Python, vous devrez "
+"peut-être aussi fournir une liste d'arguments à :c:func:"
+"`PyObject_CallObject`. Dans certains cas, la liste d'arguments est également "
+"fournie par le programme Python, par l'intermédiaire de la même interface "
+"qui a spécifié la fonction de rappel. Elle peut alors être sauvegardée et "
+"utilisée de la même manière que l'objet fonction. Dans d'autres cas, vous "
+"pouvez avoir à construire un nouveau n-uplet à passer comme liste "
+"d'arguments. La façon la plus simple de faire cela est d'appeler :c:func:"
+"`Py_BuildValue`. Par exemple, si vous voulez passer un code d'événement "
+"intégral, vous pouvez utiliser le code suivant ::"
 
 #: extending/extending.rst:608
 msgid ""
@@ -1026,7 +1036,7 @@ msgstr ""
 "Une différence par rapport à :c:func:`PyArg_ParseTuple` : alors que ce "
 "dernier nécessite que son premier argument soit un n-uplet (puisque les "
 "listes d'arguments Python sont toujours représentées par des *n*-uplets en "
-"interne), :c:func:`Py_BuildValue` ne construit pas toujours un *n*-uplet. Il "
+"interne), :c:func:`Py_BuildValue` ne construit pas toujours un n-uplet. Il "
 "n'en construit un que si sa chaîne formatée contient deux unités formatées "
 "ou plus. Si la chaîne formatée est vide, il renvoie ``None`` ; s'il contient "
 "exactement une unité formatée, il renvoie tout objet décrit par cette unité "
@@ -1100,6 +1110,14 @@ msgid ""
 "reference to it is deleted. When the counter reaches zero, the last "
 "reference to the object has been deleted and the object is freed."
 msgstr ""
+"Comme Python fait un usage intensif de :c:func:`malloc` et de :c:func:"
+"`free`, il a besoin d'une stratégie pour éviter les fuites de mémoire ainsi "
+"que l'utilisation de la mémoire libérée. La méthode choisie est appelée :dfn:"
+"`reference counting`. Le principe est simple : chaque objet contient un "
+"compteur, qui est incrémenté lorsqu'une référence à l'objet est stockée "
+"quelque part, et qui est décrémenté lorsqu'une référence à celui-ci est "
+"supprimée. Lorsque le compteur atteint zéro, la dernière référence à l'objet "
+"a été supprimée et l'objet est libéré."
 
 #: extending/extending.rst:888
 msgid ""
@@ -1116,6 +1134,20 @@ msgid ""
 "garbage collector will be available for C. Until then, we'll have to live "
 "with reference counts."
 msgstr ""
+"Une stratégie alternative est appelée :dfn:`automatic garbage collection` "
+"(collecte automatique des déchets). Parfois, le comptage des références est "
+"également appelé stratégie de collecte des déchets, d'où l'utilisation du "
+"terme \"automatique\" pour distinguer les deux. Le grand avantage de la "
+"collecte automatique des déchets est que l'utilisateur n'a pas besoin "
+"d'appeler :c:func:`free` explicitement. (Un autre avantage important est "
+"l'amélioration de la vitesse ou de l'utilisation de la mémoire --- ce n'est "
+"cependant pas un fait avéré). L'inconvénient est que pour C, il n'y a pas de "
+"collecte automatique des déchets vraiment portable, alors que le comptage "
+"des références peut être implémenté de façon portable (tant que les "
+"fonctions :c:func:`malloc` et :c:func:`free` soient disponibles --- ce que "
+"la norme C garantit). Peut-être qu'un jour un collecteur automatique de "
+"déchets suffisamment portable sera disponible pour C. D'ici là, nous devrons "
+"utiliser les compteurs des références."
 
 #: extending/extending.rst:900
 msgid ""
@@ -1193,12 +1225,12 @@ msgstr ""
 "``Py_DECREF(x)`` ? Commençons par définir quelques termes. Personne ne "
 "possède un objet, mais vous pouvez en :dfn:`avoir une référence`. Le "
 "comptage de références d'un objet est maintenant défini comme étant le "
-"nombre de références à cet objet. Le propriétaire "
-"d'une référence est responsable d'appeler :c:func:`Py_DECREF` lorsque la "
-"référence n'est plus nécessaire. La propriété d'une référence peut être "
-"transférée. Il y a trois façons de disposer d'une référence : "
-"la transmettre, la stocker, ou appeler :c:func:`Py_DECREF`. Oublier de se "
-"débarrasser d'une référence crée une fuite de mémoire."
+"nombre de références à cet objet. Le propriétaire d'une référence est "
+"responsable d'appeler :c:func:`Py_DECREF` lorsque la référence n'est plus "
+"nécessaire. La propriété d'une référence peut être transférée. Il y a trois "
+"façons de disposer d'une référence : la transmettre, la stocker, ou appeler :"
+"c:func:`Py_DECREF`. Oublier de se débarrasser d'une référence crée une fuite "
+"de mémoire."
 
 #: extending/extending.rst:943
 msgid ""
@@ -1353,6 +1385,13 @@ msgid ""
 "defined a :meth:`__del__` method.  If this class instance has a reference "
 "count of 1, disposing of it will call its :meth:`__del__` method."
 msgstr ""
+"Suivons le flux de contrôle dans :c:func:`PyList_SetItem`. La liste possède "
+"des références à tous ses éléments, donc quand l'élément 1 est remplacé, "
+"elle doit se débarrasser de l'élément 1 original.  Supposons maintenant que "
+"l'élément 1 original était une instance d'une classe définie par "
+"l'utilisateur, et supposons en outre que la classe définisse une méthode :"
+"meth:`__del__`.  Si l'instance de cette classe a un nombre des références de "
+"1, sa destruction appellera sa méthode :meth:`__del__`."
 
 #: extending/extending.rst:1043
 msgid ""
@@ -1440,13 +1479,19 @@ msgid ""
 "that may be ``NULL`` is received, for example, from :c:func:`malloc` or from "
 "a function that may raise an exception."
 msgstr ""
+"Il est préférable de tester la présence de ``NULL`` uniquement au début : "
+"lorsqu'un pointeur qui peut être ``NULL`` est reçu, par exemple, de :c:func:"
+"`malloc` ou d'une fonction qui peut lever une exception."
 
 #: extending/extending.rst:1106
 msgid ""
 "The macros :c:func:`Py_INCREF` and :c:func:`Py_DECREF` do not check for "
 "``NULL`` pointers --- however, their variants :c:func:`Py_XINCREF` and :c:"
 "func:`Py_XDECREF` do."
 msgstr ""
+"Les macros :c:func:`Py_INCREF` et :c:func:`Py_DECREF` ne vérifient pas les "
+"pointeurs ``NULL``. Cependant, leurs variantes :c:func:`Py_XINCREF` et :c:"
+"func:`Py_XDECREF` le font."
 
 #: extending/extending.rst:1110
 msgid ""
@@ -1468,17 +1513,19 @@ msgstr ""
 "il garantit qu'il s'agit toujours d'un n-uplet [#]_."
 
 #: extending/extending.rst:1120
+#, fuzzy
 msgid ""
 "It is a severe error to ever let a ``NULL`` pointer \"escape\" to the Python "
 "user."
 msgstr ""
+"C'est une grave erreur de laisser un pointeur ``NULL`` \"échapper\" vers "
+"l'utilisateur Python."
 
 #: extending/extending.rst:1131
 msgid "Writing Extensions in C++"
 msgstr "Écrire des extensions en C++"
 
 #: extending/extending.rst:1133
-#, fuzzy
 msgid ""
 "It is possible to write extension modules in C++.  Some restrictions apply.  "
 "If the main program (the Python interpreter) is compiled and linked by the C "
@@ -1498,9 +1545,9 @@ msgstr ""
 "seront appelées par l'interpréteur Python (en particulier, les fonctions "
 "d'initialisation des modules) doivent être déclarées en utilisant le \"C\" "
 "externe. Il n'est pas nécessaire d'inclure les fichiers d'en-tête Python "
-"dans le ``extern \"C\" {...}``, car ils utilisent déjà ce format si le "
-"symbole ``__cplusplus`` est défini (tous les compilateurs C++ récents "
-"définissent ce symbole)."
+"dans le ``extern \"C\" {…}``, car ils utilisent déjà ce format si le symbole "
+"``__cplusplus`` est défini (tous les compilateurs C++ récents définissent ce "
+"symbole)."
 
 #: extending/extending.rst:1147
 msgid "Providing a C API for an Extension Module"
@@ -1627,12 +1674,18 @@ msgid ""
 msgstr ""
 
 #: extending/extending.rst:1205
+#, fuzzy
 msgid ""
 "The convenience function :c:func:`PyCapsule_Import` makes it easy to load a "
 "C API provided via a Capsule, but only if the Capsule's name matches this "
 "convention.  This behavior gives C API users a high degree of certainty that "
 "the Capsule they load contains the correct C API."
 msgstr ""
+"La fonction communément utilisée :c:func:`PyCapsule_Import` permet de "
+"charger facilement une API C fournie via une Capsule, mais seulement si le "
+"nom de la Capsule correspond à cette convention. Ce comportement donne aux "
+"utilisateurs d'API C un degré élevé de certitude que la Capsule qu'ils "
+"chargent contient l'API C correcte."
 
 #: extending/extending.rst:1210
 msgid ""
