주석 블록 사용#

Using Comment Blocks

이 튜토리얼에서는 VEXcode GO에서 주석 블록을 사용하는 방법을 다룹니다. 이 튜토리얼을 마치면 프로젝트 문서화를 위해 주석을 사용하는 이유와 방법을 알게 될 것입니다.

댓글 블록을 사용하면 도구 상자의 논리 - 댓글 범주에 있는 블록 스택에 직접 메모를 추가할 수 있습니다. 이 메모는 프로젝트 실행에 영향을 미치지 않으며, 자신과 다른 사람들이 프로젝트를 이해하는 데 도움을 주기 위한 것입니다.

시작 시 아래에 기본 댓글 블록이 표시됩니다.#
시작 시 :: hat events
[comment]

프로그래머는 주석을 사용하여 코드를 정리하고, 나중에 프로젝트를 다시 볼 때 자신뿐만 아니라 함께 작업하는 다른 사람들도 코드를 더 쉽게 읽고 이해할 수 있도록 합니다. 블록 이름은 해당 블록 하나만을 설명하지만, 주석은 블록 섹션 전체의 동작을 한 번에 설명할 수 있습니다. 따라서 각 블록을 개별적으로 읽지 않고도 블록들이 모여 어떤 역할을 하는지 한눈에 파악할 수 있습니다.

예를 들어, 이 프로젝트는 무언가에 부딪힐 때까지 앞으로 나아가다가 부딪히면 뒤로 물러납니다. 이렇게 작성된 내용을 이해하려면 모든 블록을 꼼꼼히 읽어야 합니다.

무언가에 부딪힐 때까지 계속 나아가다가, 부딪히면 후진하는 프로젝트.#
시작 시 :: hat events
[앞으로 v] 방향으로 주행
<[bumper v] 눌림? :: custom-led>까지 기다리기
주행 정지
[뒤로 v] 방향으로 (100) [mm v] 주행 ▶

각 섹션 위에 해당 섹션의 동작 방식을 설명하는 주석을 추가하면 프로젝트를 한눈에 더 쉽게 이해할 수 있습니다.

동일한 프로젝트에 각 섹션의 동작 방식을 설명하는 주석이 포함되어 있습니다.#
시작 시 :: hat events
[Drive forward until something is in the way.]
[앞으로 v] 방향으로 주행
<[bumper v] 눌림? :: custom-led>까지 기다리기
[Back away from the object.]
주행 정지
[뒤로 v] 방향으로 (100) [mm v] 주행 ▶

로봇을 VEXcode에 연결한 후, 시작을 선택하여 프로젝트를 실행하세요. 로봇은 앞으로 나아가다가 무언가에 부딪히면 멈추고 뒤로 물러납니다.

VEXcode GO 툴바의 스크린샷으로, 시작 버튼이 강조 표시되어 있습니다.