Python-Funktion - dir()

Ich war in letzter Zeit sehr beschäftigt und habe eine Menge Dinge zu erledigen, sodass ich nur alle zwei Tage einen Artikel aktualisieren kann. Ich möchte mich hier bei allen entschuldigen.

Heute schauen wir uns eine sehr wichtige Funktion an: dir()

Chinesische Beschreibung: Gibt ohne Parameter eine Liste von Variablen, Methoden und definierten Typen im aktuellen Bereich zurück Attribut- und Methodenliste des Parameters. Wenn das Argument die Methode __dir__() enthält, wird diese Methode aufgerufen. Wenn der Parameter __dir__() nicht enthält, sammelt diese Methode Parameterinformationen im größtmöglichen Umfang.

Parameterobjekt: Objekt, Variable, Typ.

Version: Diese Funktion ist in verschiedenen Python-Versionen verfügbar, aber die in jeder Version angezeigten Attributdetails sind unterschiedlich. Achten Sie bei der Verwendung auf den Unterschied.

Englische Beschreibung:

dir([object])

Ohne Argumente die Liste der Namen im aktuellen lokalen Bereich zurückgeben. Versuchen Sie mit einem Argument, eine Liste zurückzugeben gültiger Attribute für dieses Objekt.

Wenn das Objekt eine Methode namens __dir__() hat, wird diese Methode aufgerufen und muss die Liste der Attribute zurückgeben. Dies ermöglicht Objekten, die Implementieren Sie eine benutzerdefinierte Funktion __getattr__() oder __getattribute__(), um die Art und Weise anzupassen, wie dir() ihre Attribute meldet.

Wenn das Objekt __dir__() nicht bereitstellt, versucht die Funktion es Es ist am besten, Informationen aus dem __dict__-Attribut des Objekts (falls definiert) und aus seinem Typobjekt zu sammeln. Die resultierende Liste ist nicht unbedingt vollständig und kann ungenau sein, wenn das Objekt über ein benutzerdefiniertes __getattr__() verfügt.

Der standardmäßige dir()-Mechanismus verhält sich bei verschiedenen Objekttypen unterschiedlich, da er versucht, die relevantesten und nicht die vollständigen Informationen zu erzeugen:

Wenn das Objekt ein Modulobjekt ist, enthält die Liste die Namen der Modulattribute.

Wenn das Objekt ein Typ- oder Klassenobjekt ist, enthält die Liste die Namen seiner Attribute und rekursiv der Attribute von seine Basen.

Ansonsten enthält die Liste die Attributnamen des Objekts, die Namen der Attribute seiner Klasse und rekursiv die Attribute der Basisklassen seiner Klasse.

Die resultierende Liste ist alphabetisch sortiert . Zum Beispiel:

>>> import struct
>>> dir()   # show the names in the module namespace
['__builtins__', '__doc__', '__name__', 'struct']
>>> dir(struct)   # show the names in the struct module
['Struct', '__builtins__', '__doc__', '__file__', '__name__',
 '__package__', '_clearcache', 'calcsize', 'error', 'pack', 'pack_into',
 'unpack', 'unpack_from']
>>> class Shape(object):
        def __dir__(self):
            return ['area', 'perimeter', 'location']
>>> s = Shape()
>>> dir(s)

['area', 'perimeter', 'location']

Hinweis Weil dir() ist Es wird in erster Linie zur Erleichterung der Verwendung an einer interaktiven Eingabeaufforderung bereitgestellt, versucht jedoch eher, einen interessanten Satz von Namen bereitzustellen als einen streng oder konsistent definierten Satz von Namen, und sein detailliertes Verhalten kann sich über Versionen hinweg ändern, z. B. Metaklassenattribute sind nicht in der Ergebnisliste, wenn das Argument eine Klasse ist.

Besonderer Hinweis: Alle Codebeispiele in dieser Artikelserie basieren auf Python2.7 ohne spezielle Anweisungen

Codebeispiel:

>>> dir()
['__builtins__', '__doc__', '__name__', '__package__']
>>> import struct
>>> dir()
['__builtins__', '__doc__', '__name__', '__package__', 'struct']
>>> dir(struct)
['Struct', '__builtins__', '__doc__', '__file__', '__name__', '__package__', '_clearcache', 'calcsize','error', 'pack', 'pack_into', 'unpack', 'unpack_from']
>>> class Person(object):
...     def __dir__(self):
...             return ["name", "age", "country"]
...
>>> dir(Person)
['__class__', '__delattr__', '__dict__', '__dir__', '__doc__', '__format__', '__getattribute__','__hash__', '__init__', '__module__', '__new__', '__reduce__','__reduce_ex__', '__repr__','__setattr__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__']
>>> tom = Person()
>>> dir(tom)
['age', 'country', 'name']