Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

csv.Dialect

Agrupa opções CSV num dialeto reutilizável na leitura e escrita.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

class Local(csv.excel):
    delimiter = ';'

Agrupa opções CSV num dialeto reutilizável na leitura e escrita.

register_dialect regista o dialeto com um nome. get_dialect devolve um objeto imutável para esse nome, que também pode ser passado a reader ou writer. delimiter é um caráter e quotechar e doublequote controlam as aspas. Local herda de csv.excel e escolhe o ponto e vírgula. Entre aspas o separador permanece no campo b;c.

Os parâmetros nomeados do leitor ou escritor sobrepõem-se às opções individuais.

import csv
class Local(csv.excel):
    delimiter = ";"
assert next(csv.reader(['a;"b;c"'], dialect=Local)) == ["a", "b;c"]
assert next(csv.reader(["a|b"], dialect=Local, delimiter="|")) == ["a", "b"]
csv.register_dialect("group_local", Local)
try:
    assert next(csv.reader(["a;b"], "group_local")) == ["a", "b"]
    d = csv.get_dialect("group_local")
    try:
        d.delimiter = "|"
    except AttributeError:
        pass
    else:
        raise AssertionError
finally:
    csv.unregister_dialect("group_local")

Exemplos

import csv
class Local(csv.excel):
    delimiter = ";"

print(issubclass(Local, csv.Dialect))
print(next(csv.reader(['a;"b;c"'], dialect=Local)))

Resultado

True
['a', 'b;c']

Os parâmetros nomeados do leitor ou escritor sobrepõem-se às opções individuais.

Fontes