Python 기초

14 . 매직 메서드

imysydesu 2026. 5. 29. 17:35

 

 

 

 

 

  • 매직 메서드는 파이썬에서 특정 문법이나 연산이 실행될 때 자동으로 호출되는 특별한 메서드임
  • __len__, __str__, __getitem__ 처럼 양쪽에 밑줄(__)이 붙는 형태를 가짐
  • 클래스에 구현하면 len(obj), print(obj), obj[0], obj + obj 같은 파이썬의 기본 문법과 자연스럽게 연결되어 객체의 동작을 직접 정의할 수 있음
  • 매직 메서드는 객체를 리스트처럼 사용하거나 연산을 수행하거나 출력 형태를 바꾸는 등 파이썬의 문법과 객체를 이어주는 핵심 기능임 

 

 

 


 

 

 

 

 

1 . 객체 출력

 

 

 

 

 

1 - 1 . __str__()

 

 

  • 객체를 사람이 알기 쉬운 문자열로 표현하기 위해 사용하는 매직 메서드
  • -> print() 했을 때 어떤 문자열을 보여줄지 정함
  • -> str이 없다는 전제 하에 print()를 찍으면 메모리 주소가 출력됨
  • 이 메서드를 클래스에 정의하면 객체를 출력할 때 기본 주소값 대신 원하는 형태로 내용을 보여줄 수 있음
  • 디버깅이나 사용자 출력에 매우 유용

 

 

- print() : 화면에 내용 출력하는 역할이지 데이터를 가지고 있는 역할이 아님

- __str__은 반드시 문자열을 반환해야 함 -> return 사용 (필수)

- __str__에 return이 아닌 print()를 찍게 된다면 화면에는 출력이 되겠지만 __str__ 값 자체가 반환하는 값은 None이 됨

 

 

return f"{self.name} {self.quantity}개"

- f : f - string

 

 

 

 

 

 

1 - 2 . __repr__()

 

 

  • 객체를 개발자 관점에서 정확하게 표현하는 문자열을 반환하는 매직 메서드
  • 디버깅이나 로그에서 사용
  • repr(obj)를 호출하거나 인터프리터에서 객체를 직접 평가할 때 자동으로 호출
  • 가능하다면 객체를 다시 생성할 수 있는 형태의 문자열을 반환하는 것이 권장됨
  • __str__()이 사람이 읽기 좋은 출력이라면 __repr__()은 객체의 구조와 상태를 명확하게 보여주는 공식적 표현

 

 

- return f"Fruit(name='{self.name}', quantity={self.quantity})" : 클래스명(속성1=값1, 속성2=값2) 형태

- '{self.name}' 에서 ''(작은 따옴표)는 문자열이라는 것을 표현하기 위한 표시

 

 

 

 

 


 

 

 

 

 

 

2 . 제너레이터(generator)

 

 

  • yield 키워드를 사용해 값을 한 번에 하나씩 생성해 반환하는 반복 객체
  • 함수 형태로 간단하게 이터레이터를 만들 수 있는 파이썬의 기능
  • 일반 함수처럼 보이지만 yield를 만나면 값을 반환하면서도 실행 상태를 유지, 다음 호출 시 이어서 실행되기 때문에 전체 데이터를 한 번에 만들지 않고 필요할 때마다 생성함 -> 메모리 효율이 높음

 

 

  • for문이 내부적으로 자동으로 iter() 호출
  • 이터레이터는 이터러블로부터 실제로 값을 하나씩 꺼내는 객체 ->__iter__(), __next__() 메서드를 모두 구현하고 있음
  • __iter__()는 반복을 시작하게 함 -> for문이나 __next__를 쓰기 위해 __iter__를 
  • 먼저 사용해야 함
  • __next__()는 값을 하나씩 꺼내며 더 이상 반환할 값이 없으면 Stoplteration 예외를 발생시켜 반복을 종료 시킴

- __iter__, __next__, for문을 세트로 생각하면 편함

 

 

 

 

 

- yield 사용으로 자동으로 __iter__ + __next__ 호출

 

 

 

 

 

 

  • yield

- 값 반환, 함수 상태 저장, 다음 호출 시 저장한 값에 이어서 실행

- 제너레이터는 자동으로 __iter__ + __next__를 만들어줌

 

 

 

 

 

 

 

 


 

 

 

 

 

 

 

3 . 인덱싱

 

 

 

 

3 - 1 . __grtitem__()

 

 

  • 객체에서 인덱스나 키를 이용해 값을 조회할 때 호출되는 매직 메서드
  • obj[index] 또는 obj[key] 형태로 접근하면 자동으로 실행
  • 이 메서드를 구현하면 사용자 정의 객체도 리스트나 딕셔너리처럼 데이터를 꺼낼 수 있음
  • 내부적으로는 전달된 인덱스나 키를 기반으로 값을 반환하도록 작성하면 됨

 

 

3 - 2 . __setitem__()

 

 

  • 객체에서 인덱스나 키를 이용해 값을 할당할 때 호출되는 매직 메서드
  • obj[index] = value 형태의 코드가 실행되면 자동으로 호출
  • 이 메서드를 구현하면 사용자 정의 객체에 값을 저장하거나 수정하는 동작을 제어할 수 있음
  • 전달된 인덱스와 값을 이용해 내부 데이터를 업데이트하도록 구현

 

 

3 - 3 . __delitem__()

 

 

  • 객체에서 인덱스나 키를 이용해 값을 삭제할 때 호출되는 매직 메서드
  • del obj[index] 형태의 코드가 실행되면 자동으로 호출
  • 이 메서드를 구현하면 사용자 정의 객체에서 특정 데이터를 삭제하는 로직을 정의
  • 전달된 인덱스를 기반으로 내부 데이터를 제거하도록 작성

 

 

 

 

 

 

 

 

 

 


 

 

 

 

 

 

 

4 . 객체를 함수, 값처럼 사용

 

 

 

 

 

4 - 1 . __call__()

 

 

  • 객체를 함수처럼 호출할 수 있게 만들어주는 매직 메서드
  • obj() 형태로 객체를 실행하면 자동으로 호출
  • 이 메서드를 구현하면 클래스 인스턴스가 일반 함수처럼 동작할 수 있음
  • 내부 상태를 활용한 연산이나 처리 로직을 간결하게 표현할 수 있음

 

- 객체를 함수처럼 사용하기 때문에 연산 등을 가능하게 해줌 -> 연산 결과를 받아줄 return이 필요

 

 

 

 

 

4 - 2 __len__()

 

 

  • 객체의 길이를 정의하는 매직 메서드
  • len(obj)를 호출할 때 자동으로 실행
  • 이 메서드를 구현하면 사용자 정의 객체도 리스트나 문자열처럼 길이를 가질 수 있게 됨
  • 내부 데이터의 개수를 반환하도록 작성하면 됨

 

 

 

 

 

 


 

 

 

 

 

5 . with 문

 

 

 

  • 파일, 네트워크, DB 연결처럼 사용 후 반드시 정리가 필요한 자원을 안전하게 관리하기 위한 문법
  • 블록이 시작될 때 필요한 작업을 수행하고 종료될 때 자동으로 정리 작업을 실행해 줌
  • try - finally를 직접 작성하지 않아도 되고 예외가 발생하더라도 자원이 정상적으로 해제되도록 보장

 

 

 

5 - 1 . __enter__()

 

  • with 문에 진입할 때 자동으로 호출되는 매직 메서드
  • 자원을 준비하거나 초기화하는 역할
  • 이 메서드에서 반환한 값은  as 뒤의 변수에 할당되어 with 블록 내부에서 사용

 

 

 

5 - 2 . __exit__()

 

  • with 블록이 끝날 때 자동으로 호출되는 매직 메서드
  • 사용한 자원을 정리하는 역할
  • 이 메서드는 예외 발생 여부와 관계없이 반드시 실행되며 예외가 발생한 경우에는 예외 타입, 값, traceback 정보를 인자로 받아 처리할 수 있음
  • 괄호 () 안에는 무조건 self 외에도 exc_type(발생한 에러 종류), exc_value(발생한 에러 메시지), traceback(에러가 어디서 났는지 추적한 정보)이 들어가야 함
  • 에러가 없을 시 None 반환

 

 

 

 

- 에러 발생 X

 

 

 

- 에러 발생 O

 

 

 

 

 

 

 

 


'Python 기초' 카테고리의 다른 글

15 . 모듈  (0) 2026.06.01
13 . 예외 처리  (0) 2026.05.29
12 . 객체지향 프로그래밍 4대 패러다임  (0) 2026.05.29
11 . 객체지향 프로그래밍(OOP)  (0) 2026.05.28
10 . 사용자 정의 함수  (0) 2026.05.28