TuplaCampo

TuplaCampo

TuplaCampo(iterable: Iterable[Campo[CampoTipoT, Valor]])

Bases: tuple['Campo[CampoTipoT, Valor]', ...]

Representa uma tupla de campos com funcionalidades adicionais.

Attributes:

• nomes (tuple[str, ...]) –

  Tupla com os nomes dos campos presentes na tupla de campos.

Parameters:

• iterable (Iterable[Campo[CampoTipoT, Valor]]) –

  Iterável de campos a serem adicionados durante a criação da tupla de campos.

Raises:

• TypeError –

  Se um dos argumentos não é um campo.

Returned by:

• Estruturas de Dados TuplaCampo  TuplaCampo  __getitem__

nomes property

nomes: tuple[str, ...]

Nomes dos campos na tupla de campos.

__getitem__

__getitem__(chave: Chave | SupportsIndex) -> Campo[CampoTipoT, Valor]

__getitem__(chave: slice) -> TuplaCampo

__getitem__(
    chave: Chave | SupportsIndex | slice,
) -> Campo[CampoTipoT, Valor] | TuplaCampo

Retorna um ou mais campos na tupla de campos.

Parameters:

• chave (Chave | SupportsIndex | slice) –

  Índice, nome ou slice dos campos buscados.

Raises:

• IndexError –

  Se a chave for um valor igual a 0 (campos têm indexação iniciada em 1).

• KeyError –

  Se um campo com o nome igual a chave não for encontrado.

• TypeError –

  Se a chave não é de um tipo válido.

Returns:

• Campo[CampoTipoT, Valor] | TuplaCampo –

  Um campo ou uma tupla de campos.

Examples:

>>> campos[1]
Campo['C']('REG': '0000')

>>> campos['COD_VER']
Campo['N']('COD_VER': 0)

__contains__

__contains__(chave: object) -> bool

Determina se uma chave representa um campo na tupla de campos.

Parameters:

• chave (object) –

  Índice, nome ou campo a ser determinado se existe na tupla de campos.

Returns:

• bool –

  Se a chave representa pelo menos um dos campos da tupla de campos.

valores

valores(valores: dict[Chave, Valor] | None = None) -> dict[str, Valor]

Permite visualizar ou alterar os valores dos campos na tupla de campos.

Diferentes variações dessa função podem retornar especificamente os valores alfanumérico, numéricos ou numéricos, não nulos:

• TuplaCampo.valores() -> dict[str, Valor]
• TuplaCampo.valores_c() -> dict[str, ValorC]
• TuplaCampo.valores_n() -> dict[str, ValorN]
• TuplaCampo.valores_n0() -> dict[str, ValorN0]

Parameters:

• valores (dict[Chave, Valor] | None, default: None ) –

  Dicionário de valores a serem alterados na tupla de campos.

Raises:

• TypeError –

  Se os valores não são de um tipo válido.

Returns:

• dict[str, Valor] –

  Valores dos campos na tupla de campos, após a alteração se essa tiver ocorrida.

Examples:

>>> campos.valores()
{'NOME': 'UM', 'VALOR': 10}

>>> campos.valores({NOME: 'DOIS', 2: 20})
{'NOME': 'DOIS', 'VALOR': 20}

valores_c

valores_c(valores: dict[Chave, Valor] | None = None) -> dict[str, ValorC]

Consultar TuplaCampos.valores().

valores_n

valores_n(valores: dict[Chave, Valor] | None = None) -> dict[str, ValorN]

Consultar TuplaCampos.valores().

valores_n0

valores_n0(valores: dict[Chave, Valor] | None = None) -> dict[str, ValorN0]

Consultar TuplaCampos.valores().