include_str!() { /* proc-macro */ }Expand description
기본 파일의 마지막 확장자 앞에 선택 언어를 붙여 사용자 작성 문서를 포함한다.
문자열 리터럴 하나를 받는다. "docs/api.guide.md"는 언어 미선택 시 그대로,
한국어 선택 시 "docs/api.guide.ko.md"가 된다. 경로는 호출 패키지 기준의
/ 구분 상대 경로이며 파일명과 확장자가 필요하다. 절대 경로와 ..는 거부한다.
#[doc = cargo_textus::include_str!("docs/guide.md")]로 API 설명에 붙이거나
문자열 표현식으로 사용할 수 있다. 파일 내용 읽기와 변경 추적은 생성된 기본
include_str!에 맡긴다. 잘못된 경로나 언어 코드는 컴파일 오류이며, 선택한
파일이 없어도 기본 파일로 대체하지 않고 rustc의 파일 읽기 오류를 발생시킨다.