[250206] 매직메서드란~?

매직 메서드 (Magic Methods)란?

1. 매직 메서드 정의

매직 메서드(또는 던더 메서드, `Dunder Method`)는 파이썬 클래스에서 특정 기능을 수행하도록 미리 정의된 특수한 메서드다.

이름이 `__`(언더스코어 두 개)로 감싸여 있으며, 객체의 연산, 표현 방식, 컨테이너 기능 등을 오버라이딩하여 커스텀 동작을 구현할 때

사용한다.

예제:

class Example:
    def __init__(self, value):
        self.value = value  

    def __str__(self):
        return f"Example({self.value})"

obj = Example(10)
print(obj)  # Example(10)

 

2. 주요 매직 메서드 정리

1) 객체 생성 및 소멸 관련 메서드

메서드	설명
`__init__`	생성자, 객체 초기화
`__del__`	소멸자, 객체 삭제 시 호출
`__new__`	인스턴스 생성, `__init__`보다 먼저 호출됨
`__repr__`	공식적인 문자열 반환 (디버깅용)
`__str__`	비공식 문자열 반환 (사용자용)

2) 연산자 오버로딩 관련 메서드

메서드	연산자
`__add__`	`+`
`__sub__`	`-`
`__mul__`	`*`
`__truediv__`	`/`
`__floordiv__`	`//`
`__mod__`	`%`
`__pow__`	`**`
`__eq__`	`==`
`__ne__`	`!=`
`__lt__`	`<`
`__le__`	`<=`
`__gt__`	`>`
`__ge__`	`>=`

예제:

class Vector:
    def __init__(self, x, y):
        self.x = x
        self.y = y

    def __add__(self, other):
        return Vector(self.x + other.x, self.y + other.y)

    def __repr__(self):
        return f"Vector({self.x}, {self.y})"

v1 = Vector(2, 3)
v2 = Vector(4, 5)
print(v1 + v2)  # Vector(6, 8)

3) 속성 및 인덱스 접근 관련 메서드

메서드	설명
`__getitem__`	`obj[key]` 형태로 요소 접근
`__setitem__`	`obj[key] = value` 형태로 요소 변경
`__delitem__`	`del obj[key]` 형태로 요소 삭제
`__len__`	`len(obj)` 호출 시 길이 반환
`__contains__`	`value in obj` 실행

예제:

class CustomList:
    def __init__(self, data):
        self.data = data

    def __getitem__(self, index):
        return self.data[index]

    def __setitem__(self, index, value):
        self.data[index] = value

    def __len__(self):
        return len(self.data)

c = CustomList([1, 2, 3])
print(c[1])  # 2
c[1] = 100
print(c.data)  # [1, 100, 3]
print(len(c))  # 3

4) 호출 및 속성 관련 매직 메서드

메서드	설명
`__call__`	객체를 함수처럼 호출 가능 (`obj()`)
`__getattr__`	존재하지 않는 속성 접근 시 호출
`__setattr__`	속성 설정 시 호출 (`obj.attr = value`)
`__delattr__`	속성 삭제 시 호출 (`del obj.attr`)

예제 (`__call__` 사용):

class CallableObject:
    def __call__(self, x):
        return x * 2

obj = CallableObject()
print(obj(10))  # 20

5) 컨텍스트 매니저 관련 (`with` 문 지원)

메서드	설명
`__enter__`	`with` 문 진입 시 실행
`__exit__`	`with` 문 종료 시 실행

예제:

class FileManager:
    def __init__(self, filename, mode):
        self.file = open(filename, mode)

    def __enter__(self):
        return self.file

    def __exit__(self, exc_type, exc_value, traceback):
        self.file.close()

with FileManager("test.txt", "w") as f:
    f.write("Hello, world!")

3. 매직 메서드 활용 예시

1) 커스텀 비교 연산 구현

class Student:
    def __init__(self, name, score):
        self.name = name
        self.score = score

    def __lt__(self, other):  # `<` 연산자 오버로딩
        return self.score < other.score

s1 = Student("Alice", 85)
s2 = Student("Bob", 90)
print(s1 < s2)  # True

2) 객체를 함수처럼 사용 (`__call__`)

class Multiply:
    def __init__(self, factor):
        self.factor = factor

    def __call__(self, x):
        return x * self.factor

double = Multiply(2)
print(double(10))  # 20

 

 

매직 메서드 정리:
1️⃣ 매직 메서드는 `__init__`, `__str__`, `__add__` 같은 파이썬의 특수 메서드이다~
2️⃣ 객체 생성, 연산자 오버로딩, 속성 접근, 컨텍스트 매니저 등에 활용된다~
3️⃣ 매직 메서드를 오버라이딩하면 커스텀 동작을 정의할 수 있다~