Baixe Programação Orientada a Objetos: Métodos de Instância, Classes e Atributos e outras Resumos em PDF para Informática, somente na Docsity!
3. Modelo de dados
3.1. Objetos, valores e tipos
Objetos são abstrações do Python para dados. Todos dados em um programa Python são representados por objetos ou por relações entre objetos. (De certo modo, e em conformidade com o modelo de Von Neumann em “stored program computer”, código também é representado por objetos.) Todo objeto tem uma identidade, um tipo e um valor. A identidade de um objeto nunca muda depois de criado; você pode pensar nisso como endereço de objetos em memória. O operador ‘is’ compara as identidades de dois objetos; a função id() retorna um inteiro representando sua identidade. CPython implementation detail: Para CPython, id(x) é o endereço de memória em que x é armazenado. O tipo de um objeto determina as operações que o objeto suporta (por exemplo, “ele tem um length ?”) e também define os valores possíveis para objetos desse tipo. A função type() retorna o tipo de um objeto (que é o próprio objeto). Como sua identidade, o tipo do objeto também é imutável. [ 1 ] O valor de alguns objetos pode mudar. Objetos cujos valores podem mudar são descritos como mutáveis , objetos cujo valor não pode ser mudado uma vez que foram criados são chamados imutáveis. (O valor de um objeto contêiner que contém uma referência a um objeto mutável pode mudar quando o valor deste último for mudado; no entanto o contêiner é ainda assim considerada imutável, pois a coleção de objetos que contém não pode ser mudada. Então a imutabilidade não é estritamente o mesmo do que não haver mudanças de valor, é mais sutil.) A mutabilidade de um objeto é determinada pelo seu tipo; por exemplo, números, strings e tuplas são imutáveis, enquanto dicionários e listas são mutáveis. Os objetos nunca são destruídos explicitamente; no entanto, quando eles se tornam inacessíveis, eles podem ser coletados como lixo. Uma implementação tem permissão para adiar a coleta de lixo ou omiti-la completamente – é uma questão de qualidade de implementação como a coleta de lixo é implementada, desde que nenhum objeto seja coletado que ainda esteja acessível. CPython implementation detail: CPython atualmente usa um esquema de contagem de referências com detecção atrasada (opcional) de lixo ligado ciclicamente, que coleta a maioria dos objetos assim que eles se tornam inacessíveis, mas não é garantido que coletará lixo contendo referências circulares. Veja a documentação do módulo gc para informações sobre como controlar a coleta de lixo cíclico. Outras implementações agem de forma diferente e o CPython pode mudar. Não dependa da finalização imediata dos objetos quando eles se tornarem inacessíveis (isto é, você deve sempre fechar os
arquivos explicitamente). Observe que o uso dos recursos de rastreamento ou depuração da implementação pode manter os objetos ativos que normalmente seriam coletáveis. Observe também que capturar uma exceção com uma instrução “try…except” pode manter os objetos vivos. Alguns objetos contêm referências a recursos “externos”, como arquivos abertos ou janelas. Entende-se que esses recursos são liberados quando o objeto é coletado como lixo, mas como a coleta de lixo não é garantida, tais objetos também fornecem uma maneira explícita de liberar o recurso externo, geralmente um método close(). Os programas são fortemente recomendados para fechar explicitamente esses objetos. A instrução “try…finally” e a instrução “with” fornecem maneiras convenientes de fazer isso. Alguns objetos contêm referências a outros objetos; eles são chamados de contêineres. Exemplos de contêineres são tuplas, listas e dicionários. As referências fazem parte do valor de um contêiner. Na maioria dos casos, quando falamos sobre o valor de um contêiner, nos referimos aos valores, não às identidades dos objetos contidos; entretanto, quando falamos sobre a mutabilidade de um contêiner, apenas as identidades dos objetos contidos imediatamente estão implícitas. Portanto, se um contêiner imutável (como uma tupla) contém uma referência a um objeto mutável, seu valor muda se esse objeto mutável for alterado. Os tipos afetam quase todos os aspectos do comportamento do objeto. Até mesmo a importância da identidade do objeto é afetada em algum sentido: para tipos imutáveis, as operações que calculam novos valores podem realmente retornar uma referência a qualquer objeto existente com o mesmo tipo e valor, enquanto para objetos mutáveis isso não é permitido. Por exemplo, após a = 1; b = 1 , a e b podem ou não se referir ao mesmo objeto com o valor um, dependendo da implementação, mas após c = []; d = [], c e d têm a garantia de referir-se a duas listas vazias diferentes e únicas. (Observe que c = d = [] atribui o mesmo objeto para c e d.)
3.2. A hierarquia de tipos padrão
Abaixo está uma lista dos tipos que são embutidos no Python. Módulos de extensão (escritos em C, Java ou outras linguagens, dependendo da implementação) podem definir tipos adicionais. Versões futuras do Python podem adicionar tipos à hierarquia de tipo (por exemplo, números racionais, matrizes de inteiros armazenadas de forma eficiente, etc.), embora tais adições sejam frequentemente fornecidas por meio da biblioteca padrão. Algumas das descrições de tipo abaixo contêm um parágrafo listando “atributos especiais”. Esses são atributos que fornecem acesso à implementação e não se destinam ao uso geral. Sua definição pode mudar no futuro. None Este tipo possui um único valor. Existe um único objeto com este valor. Este objeto é
negativos). Existem dois tipos de inteiros: Integers (int) Eles representam números em um intervalo ilimitado, sujeito apenas à memória (virtual) disponível. Para o propósito de operações de deslocamento e máscara, uma representação binária é assumida e os números negativos são representados em uma variante do complemento de 2 que dá a ilusão de uma string infinita de bits de sinal estendendo-se para a esquerda. Booleanos (bool) Estes representam os valores da verdade Falsos e Verdadeiros. Os dois objetos que representam os valores False e True são os únicos objetos booleanos. O tipo booleano é um subtipo do tipo inteiro, e os valores booleanos se comportam como os valores 0 e 1, respectivamente, em quase todos os contextos, com exceção de que, quando convertidos em uma string, as strings "False" ou "True" são retornados, respectivamente. As regras para representação de inteiros têm como objetivo fornecer a interpretação mais significativa das operações de deslocamento e máscara envolvendo inteiros negativos. numbers.Real (float) Eles representam números de ponto flutuante de precisão dupla no nível da máquina. Você está à mercê da arquitetura da máquina subjacente (e implementação C ou Java) para o intervalo aceito e tratamento de estouro. Python não oferece suporte a números de ponto flutuante de precisão única; a economia no uso do processador e da memória, que normalmente é o motivo de usá-los, é ofuscada pela sobrecarga do uso de objetos em Python, portanto, não há razão para complicar a linguagem com dois tipos de números de ponto flutuante. numbers.Complex (complex) Eles representam números complexos como um par de números de ponto flutuante de precisão dupla no nível da máquina. As mesmas advertências se aplicam aos números de ponto flutuante. As partes reais e imaginárias de um número complexo z podem ser obtidas através dos atributos somente leitura z.real e z.imag. Sequências Eles representam conjuntos ordenados finitos indexados por números não negativos. A função embutida len() retorna o número de itens de uma sequência. Quando o comprimento de uma sequência é n , o conjunto de índices contém os números 0, 1, …, n -1. O item i da sequência a é selecionado por a[i]. Sequências também suportam fatiamento: a[i:j] seleciona todos os itens com índice k de forma que i <= k < j. Quando usada como expressão, uma fatia é uma
sequência do mesmo tipo. Isso implica que o conjunto de índices é renumerado para que comece em 0. Algumas sequências também suportam “fatiamento estendido” com um terceiro parâmetro de “etapa”: a[i:j:k] seleciona todos os itens de a com índice x onde x = i + n*k, n >= 0 e i <= x < j. As sequências são distinguidas de acordo com sua mutabilidade: Sequências imutáveis Um objeto de um tipo de sequência imutável não pode ser alterado depois de criado. (Se o objeto contiver referências a outros objetos, esses outros objetos podem ser mutáveis e podem ser alterados; no entanto, a coleção de objetos diretamente referenciada por um objeto imutável não pode ser alterada.) Os tipos a seguir são sequências imutáveis: Strings Uma string é uma sequência de valores que representam pontos de código Unicode. Todos os pontos de código no intervalo U+0000 - U+10FFFF podem ser representados em uma string. Python não tem um tipo char; em vez disso, cada ponto de código na string é representado como um objeto string com comprimento 1. A função embutida ord() converte um ponto de código de sua forma de string para um inteiro no intervalo 0 - 10FFFF; chr() converte um inteiro no intervalo 0 - 10FFFF para o objeto de string correspondente de comprimento 1. str.encode() pode ser usado para converter uma str para bytes usando a codificação de texto fornecida, e bytes.decode() pode ser usado para conseguir o oposto. Tuplas Os itens de uma tupla são objetos Python arbitrários. Tuplas de dois ou mais itens são formadas por listas de expressões separadas por vírgulas. Uma tupla de um item (um “singleton”) pode ser formada afixando uma vírgula a uma expressão (uma expressão por si só não cria uma tupla, já que os parênteses devem ser usados para agrupamento de expressões). Uma tupla vazia pode ser formada por um par vazio de parênteses. Bytes Um objeto bytes é um vetor imutável. Os itens são bytes de 8 bits, representados por inteiros no intervalo 0 <= x < 256. Literais de bytes (como b'abc') e o construtor embutido bytes() podem ser usados para criar objetos bytes. Além disso, os objetos bytes podem ser decodificados em strings através do método decode(). Sequências mutáveis As sequências mutáveis podem ser alteradas após serem criadas. As notações de
Eles representam conjuntos finitos de objetos indexados por conjuntos de índices arbitrários. A notação subscrito a[k] seleciona o item indexado por k do mapeamento a; isso pode ser usado em expressões e como alvo de atribuições ou instruções del. A função embutida len() retorna o número de itens em um mapeamento. Atualmente, há um único tipo de mapeamento intrínseco: Dicionários Eles representam conjuntos finitos de objetos indexados por valores quase arbitrários. Os únicos tipos de valores não aceitáveis como chaves são os valores que contêm listas ou dicionários ou outros tipos mutáveis que são comparados por valor em vez de por identidade de objeto, o motivo é que a implementação eficiente de dicionários requer que o valor de hash de uma chave permaneça constante. Os tipos numéricos usados para chaves obedecem às regras normais para comparação numérica: se dois números forem iguais (por exemplo, 1 e 1.0), eles podem ser usados alternadamente para indexar a mesma entrada do dicionário. Dicionários preservam a ordem de inserção, o que significa que as chaves serão produzidas na mesma ordem em que foram adicionadas sequencialmente no dicionário. Substituir uma chave existente não altera a ordem, no entanto, remover uma chave e inseri-la novamente irá adicioná-la ao final em vez de manter seu lugar anterior. Os dicionários são mutáveis; eles podem ser criados pela notação {...} (veja a seção Dictionary displays). Os módulos de extensão dbm.ndbm e dbm.gnu fornecem exemplos adicionais de tipos de mapeamento, assim como o módulo collections. Alterado na versão 3.7: Dicionários não preservavam a ordem de inserção nas versões do Python anteriores à 3.6. No CPython 3.6, a ordem de inserção foi preservada, mas foi considerada um detalhe de implementação naquela época, em vez de uma garantia de linguagem. Tipos chamáveis Estes são os tipos aos quais a operação de chamada de função (veja a seção Calls) pode ser aplicada: Funções definidas pelo usuário Um objeto função definido pelo usuário será criado pela definição de função (veja a seção Definições de função). A mesma deverá ser invocada com uma lista de argumentos contendo o mesmo número de itens que a lista de parâmetros formais da função. Atributos especiais:
Atributo Significado doc A string de documentação da função, ou None se indisponível; não herdado por subclasses. Gravável name O nome da função. Gravável qualname O nome qualificado da função. Novo na versão 3.3. Gravável module O nome do módulo em que a função foi definida ou None se indisponível. Gravável defaults Uma tupla contendo valores de argumento padrão para aqueles argumentos que possuem padrões, ou None se nenhum argumento tiver um valor padrão. Gravável code O objeto código que representa o corpo da função compilada. Gravável globals Uma referência ao dicionário que contém as variáveis globais da função — o espaço de nomes global do módulo no qual a função foi definida. Somente Leitura dict O espaço de nomes que oferece suporte a atributos de função arbitrários. Gravável closure None ou uma tupla de células que contêm ligações para as variáveis livres da função. Veja abaixo as informações sobre o atributo cell_contents. Somente Leitura annotations Um dicionário contendo anotações de parâmetros. As chaves do dict são os nomes dos parâmetros e 'return' para a anotação de retorno, se fornecida. Gravável kwdefaults Um dicionário contendo padrões para parâmetros somente- nomeados. Gravável
equivalente a chamar C.f(x, 1). Quando um objeto método de instância é derivado de um objeto método de classe, a “instância de classe” armazenada em self será na verdade a própria classe, de modo que chamar x.f(1) ou C.f(1) é equivalente a chamar f(C,1) sendo f a função subjacente. Observe que a transformação de objeto função em objeto método de instância ocorre sempre que o atributo é recuperado da instância. Em alguns casos, uma otimização frutífera é atribuir o atributo a uma variável local e chamar essa variável local. Observe também que essa transformação ocorre apenas para funções definidas pelo usuário; outros objetos chamáveis (e todos os objetos não chamáveis) são recuperados sem transformação. Também é importante observar que as funções definidas pelo usuário que são atributos de uma instância de classe não são convertidas em métodos vinculados; isso apenas acontece quando a função é um atributo da classe. Funções geradoras Uma função ou método que usa a instrução yield (veja a seção The yield statement) é chamada de função geradora. Tal função, quando chamada, sempre retorna um objeto iterador que pode ser usado para executar o corpo da função: chamar o método iterator.next() do iterador fará com que a função seja executada até que forneça um valor usando a instrução yield. Quando a função executa uma instrução return ou sai do fim, uma exceção StopIteration é levantada e o iterador terá alcançado o fim do conjunto de valores a serem retornados. Funções de corrotina Uma função ou um método que é definida(o) usando async def é chamado de função de corrotina. Tal função, quando chamada, retorna um objeto de corrotina. Ele pode conter expressões await, bem como instruções async with e async for. Veja também a seção Objetos corrotina. Funções geradoras assíncronas Uma função ou um método que é definida(o) usando async def e que usa a instrução yield é chamada de função geradora assíncrona. Tal função, quando chamada, retorna um objeto iterador assíncrono que pode ser usado em uma instrução async for para executar o corpo da função. Chamar o método aiterator.anext() do iterador assíncrono retornará um aguardável que, quando aguardado, será executado até fornecer um valor usando a expressão yield. Quando a função executa uma instrução vazia return ou cai no final, uma exceção StopAsyncIteration é levantada e o iterador assíncrono terá alcançado o final do conjunto de valores a serem produzidos.
Funções embutidas Um objeto função embutida é um wrapper em torno de uma função C. Exemplos de funções embutidas são len() e math.sin() (math é um módulo embutido padrão). O número e o tipo dos argumentos são determinados pela função C. Atributos especiais de somente leitura: doc é a string de documentação da função, ou None se indisponível; name é o nome da função; self é definido como None (mas veja o próximo item); module é o nome do módulo no qual a função foi definida ou None se indisponível. Métodos embutidos Este é realmente um disfarce diferente de uma função embutida, desta vez contendo um objeto passado para a função C como um argumento extra implícito. Um exemplo de método embutido é alist.append(), presumindo que alist é um objeto de lista. Nesse caso, o atributo especial de somente leitura self é definido como o objeto denotado por alist. Classes Classes são chamáveis. Esses objetos normalmente agem como fábricas para novas instâncias de si mesmos, mas variações são possíveis para tipos de classe que substituem new(). Os argumentos da chamada são passados para new() e, no caso típico, para init() para inicializar a nova instância. Instâncias de classes Instâncias de classes arbitrárias podem ser tornados chamáveis definindo um método call() em sua classe. Módulos Módulos são uma unidade organizacional básica do código Python, e são criados pelo sistema de importação como invocado pela instrução import, ou chamando funções como importlib.import_module() e a embutida import(). Um objeto de módulo tem um espaço de nomes implementado por um objeto de dicionário (este é o dicionário referenciado pelo atributo globals de funções definidas no módulo). As referências de atributos são traduzidas para pesquisas neste dicionário, por exemplo, m.x é equivalente a m.dict["x"]. Um objeto de módulo não contém o objeto código usado para inicializar o módulo (uma vez que não é necessário depois que a inicialização é concluída). A atribuição de atributo atualiza o dicionário de espaço de nomes do módulo, por exemplo, m.x = 1 é equivalente a m.dict["x"] = 1. Atributos predefinidos (graváveis): name é o nome do módulo; doc é a string de documentação do módulo, ou None se indisponível; annotations (opcional) é um dicionário contendo anotações de variáveis coletadas durante a execução do corpo do módulo; file é o caminho do arquivo do qual o módulo foi carregado, se ele foi carregado de um arquivo. O atributo file pode estar
Instâncias de classe Uma instância de classe é criada chamando um objeto classe (veja acima). Uma instância de classe tem um espaço de nomes implementado como um dicionário que é o primeiro lugar no qual as referências de atributos são pesquisadas. Quando um atributo não é encontrado lá, e a classe da instância possui um atributo com esse nome, a pesquisa continua com os atributos da classe. Se for encontrado um atributo de classe que seja um objeto função definido pelo usuário, ele é transformado em um objeto método de instância cujo atributo self é a instância. Métodos estáticos e objetos método de classe também são transformados; veja acima em “Classes”. Veja a seção Implementando descritores para outra maneira em que os atributos de uma classe recuperados através de suas instâncias podem diferir dos objetos realmente armazenados no dict da classe. Se nenhum atributo de classe for encontrado, e a classe do objeto tiver um método getattr(), que é chamado para satisfazer a pesquisa. As atribuições e exclusões de atributos atualizam o dicionário da instância, nunca o dicionário de uma classe. Se a classe tem um método setattr() ou delattr(), ele é chamado ao invés de atualizar o dicionário da instância diretamente. As instâncias de classe podem fingir ser números, sequências ou mapeamentos se tiverem métodos com certos nomes especiais. Veja a seção Nomes de métodos especiais. Atributos especiais: dict é o dicionário de atributos; class é a classe da instância. Objetos de E/S (também conhecidos como objetos arquivo) O objeto arquivo representa um arquivo aberto. Vários atalhos estão disponíveis para criar objetos arquivos: a função embutida open(), e também os.popen(), os.fdopen() e o método makefile() de objetos soquete (e talvez por outras funções ou métodos fornecidos por módulos de extensão). Os objetos sys.stdin, sys.stdout e sys.stderr são inicializados para objetos arquivo que correspondem aos fluxos de entrada, saída e erro padrão do interpretador; eles são todos abertos em modo texto e, portanto, seguem a interface definida pela classe abstrata io.TextIOBase. Tipos internos Alguns tipos usados internamente pelo interpretador são expostos ao usuário. Suas definições podem mudar com versões futuras do interpretador, mas são mencionadas aqui para fins de integridade. Objetos código Objetos código representam código Python executável compilados em bytes ou bytecode. A diferença entre um objeto código e um objeto função é que o objeto função contém uma referência explícita aos globais da função (o módulo no qual
foi definida), enquanto um objeto código não contém nenhum contexto; também os valores de argumento padrão são armazenados no objeto função, não no objeto código (porque eles representam os valores calculados em tempo de execução). Ao contrário dos objetos função, os objetos código são imutáveis e não contêm referências (direta ou indiretamente) a objetos mutáveis. Atributos especiais de somente leitura: co_name fornece o nome da função; co_argcount é o número total de argumentos posicionais (incluindo argumentos apenas posicionais e argumentos com valores padrão); co_posonlyargcount é o número de argumentos somente-posicionais (incluindo argumentos com valores padrão); co_kwonlyargcount é o número de argumentos somente-nomeados (incluindo argumentos com valores padrão); co_nlocals é o número de variáveis locais usadas pela função (incluindo argumentos); co_varnames é uma tupla contendo os nomes das variáveis locais (começando com os nomes dos argumentos); co_cellvars é uma tupla contendo os nomes das variáveis locais que são referenciadas por funções aninhadas; co_freevars é uma tupla contendo os nomes das variáveis livres; co_code é uma string que representa a sequência de instruções de bytecode; co_consts é uma tupla contendo os literais usados pelo bytecode; co_names é uma tupla contendo os nomes usados pelo bytecode; co_filename é o nome do arquivo a partir do qual o código foi compilado; co_firstlineno é o número da primeira linha da função; co_lnotab é uma string que codifica o mapeamento de deslocamentos de bytecode para números de linha (para detalhes, veja o código-fonte do interpretador); co_stacksize é o tamanho de pilha necessário; co_flags é um inteiro que codifica uma série de sinalizadores para o interpretador. Os seguintes bits de sinalizador são definidos para co_flags: o bit 0x04 é definido se a função usa a sintaxe *arguments para aceitar um número arbitrário de argumentos posicionais; o bit 0x08 é definido se a função usa a sintaxe **keywords para aceitar argumentos nomeados arbitrários; o bit 0x20 é definido se a função for um gerador. Declarações de recursos futuros (from future import division) também usam bits em co_flags para indicar se um objeto código foi compilado com um recurso específico habilitado: o bit 0x2000 é definido se a função foi compilada com divisão futura habilitada; os bits 0x10 e 0x1000 foram usados em versões anteriores do Python. Outros bits em co_flags são reservados para uso interno. Se um objeto código representa uma função, o primeiro item em co_consts é a string de documentação da função, ou None se indefinido. Objetos quadro Objetos quadro representam quadros de execução. Eles podem ocorrer em
exceção é inserido, o stack trace é disponibilizado para o programa. (Veja a seção The try statement.) É acessível como o terceiro item da tupla retornada por sys.exc_info(), e como o atributo traceback da exceção capturada. Quando o programa não contém um manipulador adequado, o stack trace é escrito (formatado de maneira adequada) no fluxo de erro padrão; se o interpretador for interativo, ele também é disponibilizado ao usuário como sys.last_traceback. Para tracebacks criados explicitamente, cabe ao criador do traceback determinar como os atributos tb_next devem ser vinculados para formar um stack trace completo. Atributos especiais de somente leitura: tb_frame aponta para o quadro de execução do nível atual; tb_lineno fornece o número da linha onde ocorreu a exceção; tb_lasti indica a instrução precisa. O número da linha e a última instrução no traceback podem diferir do número da linha de seu objeto quadro se a exceção ocorreu em uma instrução try sem cláusula except correspondente ou com uma cláusula finally. Atributo especial de escrita: tb_next é o próximo nível no stack trace (em direção ao quadro onde a exceção ocorreu), ou None se não houver próximo nível. Alterado na versão 3.7: Os objetos traceback agora podem ser explicitamente instanciados a partir do código Python, e o atributo tb_next das instâncias existentes pode ser atualizado. Objetos slice Objetos slice são usados para representar fatias para métodos getitem(). Eles também são criados pela função embutida slice(). Atributos especiais de somente leitura: start é o limite inferior; stop é o limite superior; step é o valor intermediário; cada um é None se omitido. Esses atributos podem ter qualquer tipo. Objetos slice têm suporte a um método:
slice. indices ( self , length )
Este método usa um único argumento inteiro length e calcula informações sobre a fatia que o objeto slice descreveria se aplicado a uma sequência de itens de length. Ele retorna uma tupla de três inteiros; respectivamente, estes são os índices start e stop e o step ou comprimento de avanços da fatia. Índices ausentes ou fora dos limites são tratados de maneira consistente com fatias regulares. Objetos método estáticos Objetos método estáticos fornecem uma maneira de derrotar a transformação de
objetos função em objetos método descritos acima. Um objeto método estático é um wrapper em torno de qualquer outro objeto, geralmente um objeto método definido pelo usuário. Quando um objeto método estático é recuperado de uma classe ou instância de classe, o objeto realmente retornado é o objeto envolto, que não está sujeito a nenhuma transformação posterior. Os objetos método estáticos não são chamáveis, embora os objetos que envolvem geralmente o sejam. Objetos método estáticos são criados pelo construtor embutido staticmethod(). Objetos métodos de classe Um objeto método de classe, como um objeto método estático, é um invólucro em torno de outro objeto que altera a maneira como esse objeto é recuperado de classes e instâncias de classe. O comportamento dos objetos método de classe após tal recuperação é descrito acima, em “Métodos definidos pelo usuário”. Objetos método de classe são criados pelo construtor embutido classmethod().
3.3. Nomes de métodos especiais
Uma classe pode implementar certas operações que são chamadas por sintaxe especial (como operações aritméticas ou subscript e fatiamento), definindo métodos com nomes especiais. Esta é a abordagem do Python para sobrecarga de operador , permitindo que as classes definam seu próprio comportamento em relação aos operadores da linguagem. Por exemplo, se uma classe define um método chamado getitem(), e x é uma instância desta classe, então x[i] é aproximadamente equivalente a type(x).getitem(x, i). Exceto onde mencionado, as tentativas de executar uma operação levantam uma exceção quando nenhum método apropriado é definido (tipicamente AttributeError ou TypeError). Definir um método especial para None indica que a operação correspondente não está disponível. Por exemplo, se uma classe define iter() para None, a classe não é iterável, então chamar iter() em suas instâncias irá levantar um TypeError (sem retroceder para getitem()). [ 2 ] Ao implementar uma classe que emula qualquer tipo embutido, é importante que a emulação seja implementada apenas na medida em que faça sentido para o objeto que está sendo modelado. Por exemplo, algumas sequências podem funcionar bem com a recuperação de elementos individuais, mas extrair uma fatia pode não fazer sentido. (Um exemplo disso é a interface NodeList no Document Object Model do W3C.) 3.3.1. Personalização básica object. new ( cls [, ... ]) Chamado para criar uma nova instância da classe cls. new() é um método estático (é um caso especial, então você não precisa declará-lo como tal) que recebe
CPython apenas o chama uma vez. Não é garantido que os métodos del() sejam chamados para objetos que ainda existam quando o interpretador sai. Nota: del x não chama diretamente x.del() – o primeiro diminui a contagem de referências para x em um, e o segundo só é chamado quando a contagem de referências de x atinge zero. CPython implementation detail: It is possible for a reference cycle to prevent the reference count of an object from going to zero. In this case, the cycle will be later detected and deleted by the cyclic garbage collector. A common cause of reference cycles is when an exception has been caught in a local variable. The frame’s locals then reference the exception, which references its own traceback, which references the locals of all frames caught in the traceback. Ver também: Documentação do módulo gc. Aviso: Devido às circunstâncias precárias sob as quais os métodos del() são invocados, as exceções que ocorrem durante sua execução são ignoradas e um aviso é impresso em sys.stderr em seu lugar. Em particular: del() pode ser chamado quando um código arbitrário está sendo executado, incluindo de qualquer thread arbitrário. Se del() precisar bloquear ou invocar qualquer outro recurso de bloqueio, pode ocorrer um deadlock, pois o recurso já pode ter sido levado pelo código que é interrompido para executar del(). del() pode ser executado durante o desligamento do interpretador. Como consequência, as variáveis globais que ele precisa acessar (incluindo outros módulos) podem já ter sido excluídas ou definidas como None. O Python garante que os globais cujo nome comece com um único sublinhado sejam excluídos de seu módulo antes que outros globais sejam excluídos; se nenhuma outra referência a tais globais existir, isso pode ajudar a garantir que os módulos importados ainda estejam disponíveis no momento em que o método del() for chamado.
object. repr ( self )
Chamado pela função embutida repr() para calcular a representação da string “oficial” de um objeto. Se possível, isso deve parecer uma expressão Python válida que pode ser usada para recriar um objeto com o mesmo valor (dado um ambiente apropriado). Se isso não for possível, uma string no formato <...alguma descrição útil...> deve ser retornada. O valor de retorno deve ser um objeto string. Se uma classe define repr(), mas não str(), então repr() também é usado quando uma representação de string “informal” de instâncias daquela classe é necessária.
Isso é normalmente usado para depuração, portanto, é importante que a representação seja rica em informações e inequívoca.
object. str ( self )
Chamado por str(object) e as funções embutidas format() e print() para calcular a representação da string “informal” ou agradável para exibição de um objeto. O valor de retorno deve ser um objeto string. Este método difere de object.repr() por não haver expectativa de que str() retorne uma expressão Python válida: uma representação mais conveniente ou concisa pode ser usada. A implementação padrão definida pelo tipo embutido object chama object.repr().
object. bytes ( self )
Chamado por bytes para calcular uma representação de string de bytes de um objeto. Isso deve retornar um objeto bytes.
object. format ( self , format_spec )
Chamado pela função embutida format() e, por extensão, avaliação de literais de string formatadas e o método str.format(), para produzir uma representação de string “formatada” de um objeto. O argumento format_spec é uma string que contém uma descrição das opções de formatação desejadas. A interpretação do argumento format_spec depende do tipo que implementa format(), entretanto a maioria das classes delegará a formatação a um dos tipos embutidos ou usará uma sintaxe de opção de formatação semelhante. Consulte Minilinguagem de especificação de formato para uma descrição da sintaxe de formatação padrão. O valor de retorno deve ser um objeto string. Alterado na versão 3.4: O método format do próprio object levanta uma TypeError se passada qualquer string não vazia. Alterado na versão 3.7: object.format(x, '') é agora equivalente a str(x) em vez de format(str(x), '').
object. lt ( self , other )
object. le ( self , other )
object. eq ( self , other )
object. ne ( self , other )
object. gt ( self , other )
object. ge ( self , other )
Esses são os chamados métodos de “comparação rica”. A correspondência entre os
