DESCRIPTION.

Sauvegarde n'importe quel type d'objet valide pour Python sous la forme d'un fichier binaire.

SYNTAXE.

marshal.dump ( objet , fichier , protocole , * , version , tampon )

marshal.dump ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

objet ⇨ objet à sauvegarder [ OBLIGATOIRE ]

fichier ⇨ identification du fichier destinataire [ OBLIGATOIRE ]

protocole ⇨ protocole de sérialisation [ optionnel ]

version ⇨ compatibilité entre les versions de Python [ optionnel ]

tampon ⇨ comportement de la mémoire tampon [ optionnel ]

REMARQUES.

objet doit être un objet valide pour Python ( list ( ), dict ( ), tuple ( ), ...) existant au moment de l'appel de la méthode.

fichier doit désigner un fichier valide, ouvert en écriture, exprimé avec un chemin relatif ou absolu.

protocole doit être un int ( ) désignant le protocole valide à utiliser pour la sérialisation de objet. Par défaut objet vaut 0, c'est-à-dire aucun. 

version doit être un bool ( ) qui précise s'il faut forcer la compatibilité entre les objets Python 2x et Python 3x. Par défaut version vaut True.

tampon est utilisé pour la gestion et le comportement de la mémoire tampon. Par défut tampon vaut None.

La modification des paramètres par défaut des attributs protocole, version et tampon doivent être utilisés avec beaucoup de précautions.

Les objets sauvegardés sous forme de fichiers, avec la méthode marshal.dump ( ), sont toujours écrit en binaire par pickle, il faut donc le préciser à la méthode open ( ) par "wb". Pour plus de sûreté, utilisez toujours l'instruction with pour travailler sur vos fichiers. 

EXEMPLE.

import marshal

LST_Jours = [ "Lundi" , "Mardi" , "Mercredi" , "Jeudi" , "Vendredi" , "Samedi" , "Dimanche" ]

kjours = open ( "les jours.lst" , "wb" )

marshal.dump ( LST_Jours , kjours )

kjours.close ( )

LST_Jours [ : ] = [ "Monday" , "Tuesday" , "Wednesday" , "Thursday" , "Friday" , "Saturday" , "Sunday" ]

klecture = open ( "les jours.lst" , "rb" )

LST_Semaine = marshal.load ( klecture )

klecture.close ( )

# --- Controle  de l'opération ---

print ( "LST_Jours" , LST_Jours )

print ( "LST_Semaine" , LST_Semaine )

print ( type ( LST_Semaine ) )

Pour plus de sûreté, utilisez toujours l'instruction with pour travailler sur vos fichiers.

import pickle

LST_Jours = [ "Lundi" , "Mardi" , "Mercredi" , "Jeudi" , "Vendredi" , "Samedi" , "Dimanche" ]

with open ( "les jours.lst" , "wb" ) as kjours : marshal.dump ( LST_Jours , kjours )

print ( "LST_Jours" , LST_Jours , "\n" )

LST_Jours [ : ] = [ "Monday" , "Tuesday" , "Wednesday" , "Thursday" , "Friday" , "Saturday" , "Sunday" ]

with open ( "les jours.lst" , "rb" ) as ksemaine : LST_Semaine = marshal.load ( ksemaine )

print ( "LST_Jours" , LST_Jours )

print ( "LST_Semaine" , LST_Semaine )

print ( type ( LST_Semaine ) )