Статические методы в Python? - PullRequest
1567 голосов
/ 10 апреля 2009

Возможно ли иметь статические методы в Python, чтобы я мог вызывать их без инициализации класса, например:

ClassName.StaticMethod ( )

Ответы [ 10 ]

1879 голосов
/ 10 апреля 2009

Да, используя статический метод

class MyClass(object):
    @staticmethod
    def the_static_method(x):
        print x

MyClass.the_static_method(2) # outputs 2

Обратите внимание, что некоторый код может использовать старый метод определения статического метода, используя staticmethod как функцию, а не как декоратор. Это следует использовать, только если вы должны поддерживать древние версии Python (2.2 и 2.3)

class MyClass(object):
    def the_static_method(x):
        print x
    the_static_method = staticmethod(the_static_method)

MyClass.the_static_method(2) # outputs 2

Это полностью идентично первому примеру (с использованием @staticmethod), только без синтаксиса хорошего декоратора

Наконец, используйте staticmethod() экономно! В Python очень мало ситуаций, когда необходимы статические методы, и я видел, как они много раз использовались, когда отдельная функция «верхнего уровня» была бы более понятной.


Дословно из документации следует: :

Статический метод не получает неявный первый аргумент. Чтобы объявить статический метод, используйте эту идиому:

class C:
    @staticmethod
    def f(arg1, arg2, ...): ...

Форма @staticmethod представляет собой функцию декоратор - подробности см. В описании определений функций в Определения функций .

Он может быть вызван либо для класса (например, C.f()), либо для экземпляра (например, C().f()). Экземпляр игнорируется, за исключением его класса.

Статические методы в Python аналогичны тем, которые можно найти в Java или C ++. Для более продвинутой концепции см. classmethod().

Для получения дополнительной информации о статических методах см. Документацию по стандартной иерархии типов в Стандартная иерархия типов .

Новое в версии 2.2.

Изменено в версии 2.4: добавлен синтаксис функции-декоратора.

197 голосов
/ 18 апреля 2012

Я думаю, что Стивен на самом деле прав . Чтобы ответить на исходный вопрос, затем, чтобы настроить метод класса, просто предположите, что первый аргумент не будет вызывающим экземпляром, а затем убедитесь, что вы вызываете метод только из класса.

(Обратите внимание, что этот ответ относится к Python 3.x. В Python 2.x вы получите TypeError для вызова метода самого класса.)

Например:

class Dog:
    count = 0 # this is a class variable
    dogs = [] # this is a class variable

    def __init__(self, name):
        self.name = name #self.name is an instance variable
        Dog.count += 1
        Dog.dogs.append(name)

    def bark(self, n): # this is an instance method
        print("{} says: {}".format(self.name, "woof! " * n))

    def rollCall(n): #this is implicitly a class method (see comments below)
        print("There are {} dogs.".format(Dog.count))
        if n >= len(Dog.dogs) or n < 0:
            print("They are:")
            for dog in Dog.dogs:
                print("  {}".format(dog))
        else:
            print("The dog indexed at {} is {}.".format(n, Dog.dogs[n]))

fido = Dog("Fido")
fido.bark(3)
Dog.rollCall(-1)
rex = Dog("Rex")
Dog.rollCall(0)

В этом коде метод rollCall предполагает, что первый аргумент не является экземпляром (как было бы, если бы он был вызван экземпляром, а не классом). Пока "rollCall" вызывается из класса, а не из экземпляра, код будет работать нормально. Если мы попытаемся вызвать "rollCall" из экземпляра, например ::

rex.rollCall(-1)

однако, это вызвало бы возникновение исключения, потому что оно отправило бы два аргумента: себя и -1, а «rollCall» определен только для принятия одного аргумента.

Кстати, rex.rollCall () отправит правильное количество аргументов, но также вызовет исключение, потому что теперь n будет представлять экземпляр Dog (т.е. rex), когда функция ожидает, что n будет числовым.

Вот где приходит украшение: Если мы предшествуем методу rollCall с

@staticmethod

затем, явно указав, что метод является статическим, мы можем даже вызвать его из экземпляра. Сейчас

rex.rollCall(-1)

будет работать. Вставка @staticmethod перед определением метода не позволяет экземпляру отправлять себя в качестве аргумента.

В этом можно убедиться, попробовав следующий код с закомментированной строкой @staticmethod и без нее.

class Dog:
    count = 0 # this is a class variable
    dogs = [] # this is a class variable

    def __init__(self, name):
        self.name = name #self.name is an instance variable
        Dog.count += 1
        Dog.dogs.append(name)

    def bark(self, n): # this is an instance method
        print("{} says: {}".format(self.name, "woof! " * n))

    @staticmethod
    def rollCall(n):
        print("There are {} dogs.".format(Dog.count))
        if n >= len(Dog.dogs) or n < 0:
            print("They are:")
            for dog in Dog.dogs:
                print("  {}".format(dog))
        else:
            print("The dog indexed at {} is {}.".format(n, Dog.dogs[n]))


fido = Dog("Fido")
fido.bark(3)
Dog.rollCall(-1)
rex = Dog("Rex")
Dog.rollCall(0)
rex.rollCall(-1)
77 голосов
/ 10 апреля 2009

Да, проверьте статический метод декоратор:

>>> class C:
...     @staticmethod
...     def hello():
...             print "Hello World"
...
>>> C.hello()
Hello World
46 голосов
/ 10 апреля 2009

Вам не нужно использовать декоратор @staticmethod. Просто объявите метод (не ожидающий параметра self) и вызовите его из класса. Декоратор существует только в том случае, если вы хотите иметь возможность вызывать его также из экземпляра (что не было тем, что вы хотели сделать)

В основном вы просто используете функции ...

32 голосов
/ 24 января 2015

Статические методы в Python?

Возможно ли иметь статические методы в Python, чтобы я мог их вызывать без инициализации класса, например:

ClassName.StaticMethod()

Да, статические методы могут быть созданы следующим образом (хотя это немного больше Pythonic для использования подчеркивания вместо CamelCase для методов):

class ClassName(object):

    @staticmethod
    def static_method(kwarg1=None):
        '''return a value that is a function of kwarg1'''

Выше используется синтаксис декоратора. Этот синтаксис эквивалентен

class ClassName(object):

    def static_method(kwarg1=None):
        '''return a value that is a function of kwarg1'''

    static_method = staticmethod(static_method)

Это можно использовать так же, как вы описали:

ClassName.static_method()

Встроенный пример статического метода - str.maketrans() в Python 3, который был функцией в модуле string в Python 2.


Другой вариант, который можно использовать при описании, - это classmethod, отличие состоит в том, что метод класса получает класс в качестве неявного первого аргумента, а в случае подкласса получает подкласс в качестве неявного первого аргумента. *

class ClassName(object):

    @classmethod
    def class_method(cls, kwarg1=None):
        '''return a value that is a function of the class and kwarg1'''

Обратите внимание, что cls не является обязательным именем для первого аргумента, но большинство опытных программистов на Python сочтут это неправильно, если вы используете что-то еще.

Обычно они используются в качестве альтернативных конструкторов.

new_instance = ClassName.class_method()

Встроенный пример: dict.fromkeys():

new_dict = dict.fromkeys(['key1', 'key2'])
9 голосов
/ 30 июля 2014

Возможно, самый простой вариант - просто поместить эти функции вне класса:

class Dog(object):
    def __init__(self, name):
        self.name = name

    def bark(self):
        if self.name == "Doggy":
            return barking_sound()
        else:
            return "yip yip"

def barking_sound():
    return "woof woof"

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

Допустим, этот файл называется dogs.py. Чтобы использовать их, вы бы позвонили dogs.barking_sound() вместо dogs.Dog.barking_sound.

Если вам действительно нужен статический метод для участия в классе, вы можете использовать декоратор staticmethod .

9 голосов
/ 29 декабря 2012

Помимо особенностей поведения объектов статического метода , существует определенная красота, с которой вы можете поразить их, когда речь заходит об организации кода уровня модуля.

# garden.py
def trim(a):
    pass

def strip(a):
    pass

def bunch(a, b):
    pass

def _foo(foo):
    pass

class powertools(object):
    """
    Provides much regarded gardening power tools.
    """
    @staticmethod
    def answer_to_the_ultimate_question_of_life_the_universe_and_everything():
        return 42

    @staticmethod
    def random():
        return 13

    @staticmethod
    def promise():
        return True

def _bar(baz, quux):
    pass

class _Dice(object):
    pass

class _6d(_Dice):
    pass

class _12d(_Dice):
    pass

class _Smarter:
    pass

class _MagicalPonies:
    pass

class _Samurai:
    pass

class Foo(_6d, _Samurai):
    pass

class Bar(_12d, _Smarter, _MagicalPonies):
    pass

...

# tests.py
import unittest
import garden

class GardenTests(unittest.TestCase):
    pass

class PowertoolsTests(unittest.TestCase):
    pass

class FooTests(unittest.TestCase):
    pass

class BarTests(unittest.TestCase):
    pass

...

# interactive.py
from garden import trim, bunch, Foo

f = trim(Foo())
bunch(f, Foo())

...

# my_garden.py
import garden
from garden import powertools

class _Cowboy(garden._Samurai):
    def hit():
        return powertools.promise() and powertools.random() or 0

class Foo(_Cowboy, garden.Foo):
    pass

Теперь он становится немного более интуитивно понятным и самодокументируемым, в контексте которого должны использоваться определенные компоненты, и идеально подходит для именования отдельных тестовых случаев, а также для прямого подхода к тому, как тестовые модули отображаются в реальные модули в тесты для пуристов.

Я часто считаю целесообразным применять этот подход для организации служебного кода проекта. Довольно часто люди сразу же спешат создать пакет utils и в итоге получают 9 модулей, один из которых имеет 120 LOC, а остальные - в лучшем случае два десятка LOC. Я предпочитаю начать с этого и преобразовать его в пакет и создавать модули только для зверей, которые действительно заслуживают их:

# utils.py
class socket(object):
    @staticmethod
    def check_if_port_available(port):
        pass

    @staticmethod
    def get_free_port(port)
        pass

class image(object):
    @staticmethod
    def to_rgb(image):
        pass

    @staticmethod
    def to_cmyk(image):
        pass
0 голосов
/ 04 июня 2019

Итак, статические методы - это методы, которые можно вызывать без создания объекта класса. Например: -

    @staticmethod
    def add(a, b):
        return a + b

b = A.add(12,12)
print b

В приведенном выше примере метод add вызывается именем класса A, а не именем объекта.

0 голосов
/ 20 декабря 2018

Python Статические методы могут быть созданы двумя способами.

  1. Использование staticmethod ()

    class Arithmetic:
        def add(x, y):
            return x + y
    # create add static method
    Arithmetic.add = staticmethod(Arithmetic.add)
    
    print('Result:', Arithmetic.add(15, 10))
    

Выход:

Результат: 25

  1. Использование @ staticmethod

    class Arithmetic:
    
    # create add static method
    @staticmethod
    def add(x, y):
        return x + y
    
    print('Result:', Arithmetic.add(15, 10))
    

Выход:

Результат: 25

0 голосов
/ 08 января 2018

Я сталкиваюсь с этим вопросом время от времени. Пример использования и пример, который мне нравится:

jeffs@jeffs-desktop:/home/jeffs  $ python36
Python 3.6.1 (default, Sep  7 2017, 16:36:03) 
[GCC 6.3.0 20170406] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import cmath
>>> print(cmath.sqrt(-4))
2j
>>>
>>> dir(cmath)
['__doc__', '__file__', '__loader__', '__name__', '__package__', '__spec__', 'acos', 'acosh', 'asin', 'asinh', 'atan', 'atanh', 'cos', 'cosh', 'e', 'exp', 'inf', 'infj', 'isclose', 'isfinite', 'isinf', 'isnan', 'log', 'log10', 'nan', 'nanj', 'phase', 'pi', 'polar', 'rect', 'sin', 'sinh', 'sqrt', 'tan', 'tanh', 'tau']
>>> 

Нет смысла создавать объект класса cmath, потому что в объекте cmath нет состояния. Тем не менее, cmath - это набор методов, которые каким-то образом связаны между собой. В моем примере выше все функции в cmath так или иначе действуют на комплексные числа.

...