Friday, August 17, 2007
Python 주석 달기, 파이썬 블럭 코멘트, 특정 구역 주석화; Block Comment
업데이트:
파이썬에는 블록 코멘트 문법이 사실상 없습니다.
이 포스트의 방법은 다소 변칙적인 것입니다.
3중 따옴표로 블록 코멘트를 표현하는 것은 디버깅 중에만 사용하고
최종 완성본의 소스 코드에는, 각 줄에 샤프(#) 기호로 주석을 달아주는 것이 좋습니다.
다만, 파이썬의 창시자인 "귀도 반 로섬(Guido van Rossum)"은, 따옴표 3개로 블록 코멘트(multi-line comments)를 만들어도 된다고 한 것 같습니다: Python tip: You can use multi-line strings as multi-line comments. Unless used as docstrings, they generate no code! [번역] 파이썬 팁: (따옴표 3개로 된) 멀티라인 문자열을, 멀티라인 코멘트(블록 코멘트)로 사용해도 됩니다. docstring으로서 사용하지 않는 한, 코드를 생성하진 않습니다.
파이썬에서 주석을 달려면 다음과 같이 # 이런 샤프 기호를 사용하면 됩니다. 그러면 # 기호 뒤에 있는 모든 문자열들이 실행에서 무조건 무시됩니다. 설명을 기입해 넣을 수 있겠지요. 어떤 특정 구역을 모두 주석화시키려면 """ 에서 """ 까지, 이렇게 큰따옴표(쌍따옴표) 3개를 사용하면 됩니다. 다음 예제와 같습니다.
다만, 소스 첫줄의 #! 기호는 주석문이 아닙니다. "유닉스 Shebang"입니다. 둘째줄의 # 는 한글 확장완성형 인코딩 지정문입니다.
예제 소스 파일명: example.py
그런데 블럭코멘트도 적절히 "들여쓰기"를 해야 합니다. 그렇지 않으면 에러가 납니다. 참고: ▶▶ Python/파이썬] 주석 기호, 주석문 표현, 블록 코멘트; Block Comment Remark
파이썬에는 블록 코멘트 문법이 사실상 없습니다.
이 포스트의 방법은 다소 변칙적인 것입니다.
3중 따옴표로 블록 코멘트를 표현하는 것은 디버깅 중에만 사용하고
최종 완성본의 소스 코드에는, 각 줄에 샤프(#) 기호로 주석을 달아주는 것이 좋습니다.
다만, 파이썬의 창시자인 "귀도 반 로섬(Guido van Rossum)"은, 따옴표 3개로 블록 코멘트(multi-line comments)를 만들어도 된다고 한 것 같습니다: Python tip: You can use multi-line strings as multi-line comments. Unless used as docstrings, they generate no code! [번역] 파이썬 팁: (따옴표 3개로 된) 멀티라인 문자열을, 멀티라인 코멘트(블록 코멘트)로 사용해도 됩니다. docstring으로서 사용하지 않는 한, 코드를 생성하진 않습니다.
파이썬에서 주석을 달려면 다음과 같이 # 이런 샤프 기호를 사용하면 됩니다. 그러면 # 기호 뒤에 있는 모든 문자열들이 실행에서 무조건 무시됩니다. 설명을 기입해 넣을 수 있겠지요. 어떤 특정 구역을 모두 주석화시키려면 """ 에서 """ 까지, 이렇게 큰따옴표(쌍따옴표) 3개를 사용하면 됩니다. 다음 예제와 같습니다.
다만, 소스 첫줄의 #! 기호는 주석문이 아닙니다. "유닉스 Shebang"입니다. 둘째줄의 # 는 한글 확장완성형 인코딩 지정문입니다.
예제 소스 파일명: example.py
#!/usr/bin/python
# -*- coding: cp949 -*-
# 이줄은 라인 코멘트입니다
print "Hello World!"
print "Hello World!" # 이것도 라인 코멘트입니다
print "Hello World!" # 이것도 라인 코멘트입니다
print "Hello World!" # 이것도 라인 코멘트입니다
"""
이것은 블럭 코멘트입니다.
그래서 여러 줄의 주석을
이렇게 달 수 있습니다.
큰따옴표 3개를 연속으로 적으면 됩니다.
"""
print "Hello World!" # 라인 코멘트
# -*- coding: cp949 -*-
# 이줄은 라인 코멘트입니다
print "Hello World!"
print "Hello World!" # 이것도 라인 코멘트입니다
print "Hello World!" # 이것도 라인 코멘트입니다
print "Hello World!" # 이것도 라인 코멘트입니다
"""
이것은 블럭 코멘트입니다.
그래서 여러 줄의 주석을
이렇게 달 수 있습니다.
큰따옴표 3개를 연속으로 적으면 됩니다.
"""
print "Hello World!" # 라인 코멘트
그런데 블럭코멘트도 적절히 "들여쓰기"를 해야 합니다. 그렇지 않으면 에러가 납니다. 참고: ▶▶ Python/파이썬] 주석 기호, 주석문 표현, 블록 코멘트; Block Comment Remark
tag: python
Python | 파이썬 프로그래밍
블럭 코멘트를 """ 로 이용하는 것은 권장사항이 아닙니다.
https://www.python.org/dev/peps/pep-0008/#block-comments
""" """ 는 문서 문장을 만드는데 이용되는 것입니다.
파이썬 권장은 모든 라인에 #를 추가하는 것입니다.
좋은 조언 감사합니다
<< Home