Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

csv.DictWriter

Écrit des dictionnaires dans un flux texte selon l’ordre des fieldnames obligatoires.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

csv.DictWriter(f, fieldnames, restval='', extrasaction='raise', dialect='excel')

Écrit des dictionnaires dans un flux texte selon l’ordre des fieldnames obligatoires.

writeheader écrit les noms et writerow lit les clés correspondantes. Une clé absente prend restval, par défaut une chaîne vide. Une clé étrangère lève ValueError sauf avec extrasaction='ignore'.

Dans l’exemple id,score est suivi de 7,-.

import csv, io
out = io.StringIO(newline="")
w = csv.DictWriter(out, ["a"], lineterminator="\n", extrasaction="ignore")
w.writeheader()
w.writerow({"b": 2})
assert out.getvalue() == 'a\n""\n'
try:
    csv.DictWriter(out, ["a"]).writerow({"b": 2})
except ValueError:
    pass
else:
    raise AssertionError

Exemples

import csv
from io import StringIO

out = StringIO(newline="")
w = csv.DictWriter(out, ["id", "score"], restval="-", lineterminator="\n")
w.writeheader()
w.writerow({"id": 7})
print(out.getvalue(), end="")

Résultat

id,score
7,-

Dans l’exemple id,score est suivi de 7,-.

Sources