Функция dir() в Python: список имен в текущей локальной области видимости

• 08.07.2023
• 154
• Основы Python
• Функции

В Python функция dir() используется для получения списка имен, определенных в текущем пространстве имен. Проще говоря, dir() позволяет нам получить список атрибутов объекта. Это может быть любой объект: функция, модуль, строка, список, словарь и т.д.

Синтаксис

Функция dir() имеет следующий синтаксис:

dir([object])

Функция принимает один необязательный аргумент:

• object — объект, атрибуты которого требуется получить. Если объект не указан, функция возвращает список имен в текущем локальном пространстве имен.

Функция возвращает список атрибутов объекта.

Использование функции без аргументов

Если вызвать dir() без аргументов, будет возвращен список имен, определенных в текущем локальном пространстве имен:

x = 1
y = 'hello'
def test():
    pass

print(dir())

Этот код вернет список, содержащий test, x, y и другие встроенные имена.

Использование функции с аргументом

Вызов dir() с аргументом вернет список атрибутов этого объекта. Например, с аргументом str возвращает список встроенных методов строк:

print(dir(str))

#['__add__', '__class__', '__contains__', '__delattr__', '__dir__', '__doc__', '__eq__', '__format__', '__ge__', '__getattribute__', '__getitem__', '__getnewargs__', '__gt__', '__hash__', '__init__', '__init_subclass__', '__iter__', '__le__', '__len__', '__lt__', '__mod__', '__mul__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__rmod__', '__rmul__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', 'capitalize', 'casefold', 'center', 'count', 'encode', 'endswith', 'expandtabs', 'find', 'format', 'format_map', 'index', 'isalnum', 'isalpha', 'isascii', 'isdecimal', 'isdigit', 'isidentifier', 'islower', 'isnumeric', 'isprintable', 'isspace', 'istitle', 'isupper', 'join', 'ljust', 'lower', 'lstrip', 'maketrans', 'partition', 'removeprefix', 'removesuffix', 'replace', 'rfind', 'rindex', 'rjust', 'rpartition', 'rsplit', 'rstrip', 'split', 'splitlines', 'startswith', 'strip', 'swapcase', 'title', 'translate', 'upper', 'zfill']

Вывод будет включать методы, такие как __add__, __class__, __contains__, capitalize, find, format и многие другие.

Использование функции dir() с пользовательским классом

Можно использовать dir() с пользовательскими объектами для получения списка их атрибутов и методов:

class Test:
    def __init__(self, a, b):
        self.a = a
        self.b = b

    def test_method(self):
        pass

t = Test(1, 2)
print(dir(t))

Вывод будет включать a, b, test_method, а также множество встроенных методов и атрибутов.

Использование функции dir() с модулем

Можно использовать dir() с модулем для получения списка функций и классов, определенных в этом модуле:

import math

print(dir(math))

#['__doc__', '__loader__', '__name__', '__package__', '__spec__', 'acos', 'acosh', 'asin', 'asinh', 'atan', 'atan2', 'atanh', 'ceil', 'comb', 'copysign', 'cos', 'cosh', 'degrees', 'dist', 'e', 'erf', 'erfc', 'exp', 'expm1', 'fabs', 'factorial', 'floor', 'fmod', 'frexp', 'fsum', 'gamma', 'gcd', 'hypot', 'inf', 'isclose', 'isfinite', 'isinf', 'isnan', 'isqrt', 'lcm', 'ldexp', 'lgamma', 'log', 'log10', 'log1p', 'log2', 'modf', 'nan', 'nextafter', 'perm', 'pi', 'pow', 'prod', 'radians', 'remainder', 'sin', 'sinh', 'sqrt', 'tan', 'tanh', 'tau', 'trunc', 'ulp']

Вывод будет включать acos, asin, atan, cos, sin, tan и многие другие математические функции.

Использование dir() для встроенных типов и функций

Поскольку dir() работает с любым объектом, вы можете использовать его для исследования встроенных типов и функций Python. Например, вы можете использовать dir() для получения списка методов и атрибутов, доступных для словарей, списков, кортежей и других встроенных структур данных.

print(dir(list))  # Получите список методов для списков
print(dir(dict))  # Получите список методов для словарей

Вывод

Функция dir() в Python предоставляет мощный способ получения списка атрибутов любого объекта. Это может быть полезно при интерактивной работе с Python и для понимания структуры неизвестных модулей или объектов.