1.1 Comments
모든 프로그램이 필요로 하는 주석을 Rust는 몇 가지 다양한 방식으로 지원한다:
- 일반적인 주석 은 컴파일러에게 무시된다:
// 줄 주석은 라인 끝까지 포함/* 블록 주석은 구분자가 끝날 때까지 포함 */
- 문서 주석 은 HTML 라이브러리 문서로 번역된다.
/// 해당 아이템에 대한 라이브러리 문서를 생성.- `//! 둘러싼 아이템을 위한 라이브러리 문서를 생성
- Regular comments which are ignored by the compiler:
// Line comments which go to the end of the line./* Block comments which go to the closing delimiter. */
- Doc comments which are parsed into HTML library
documentation:
/// Generate library docs for the following item.//! Generate library docs for the enclosing item.
fn main() {
// 줄 주석의 예제
// 줄의 시작 부분에 두개의 슬래쉬들을 주목하라
// 여기에 쓰인 내용은 컴파일러가 읽지 않는다
// println!("Hello, world!");
// 실행해봐라. 결과를 봤으면 두 슬래쉬를 지우고 다시 실행해보도록.
/*
* 이번에는 다른 형식인 블럭 커멘트이다. 일반적으로
* 줄 주석이 추천하는 방식이지만 블록 주석은
* 임시적으로 많은 양의 코드를 비활성화 할 때
* 유용하게 사용된다. /* 블록 주석은 /* 중첩 사용이 가능하고, */ */
* 그래서 단 몇 키 입력으로 모든 라인을 주석 처리 할 수 있다.
* 이 main() 함수에서 /*/*/* 시험해봐라! */*/*/
*/
/*
참고, 이전 문단에서 '*'은 그저 스타일을 위해서 사용한 것.
실제로는 필요하지 않다.
*/
// 블록 주석을 통해 쉽게 표현을 조작할 수 있음을 보라.
// 줄 주석으론 못함. 주석 식별자를 제거하면
// 결과가 달라질 것이다:
let x = 5 + /* 90 + */ 5;
println!("Is `x` 10 or 100? x = {}", x);
}