연습 - 설명서 테스트 작성 - Training

8분

이 연습에서는 div 및 sub 함수에 대해 다음 코드 조각으로 설명서 테스트를 만듭니다.

div 함수에 대해 다음 설명서 테스트를 작성합니다.

10 나누기 2는 5임을 어설션합니다.
6 나누기 3은 2임을 어설션합니다.
10 나누기 0은 패닉임을 어설션합니다.

sub 함수에 대해 다음 설명서 테스트를 작성합니다.

9 빼기 2는 7임을 어설션합니다.
6 빼기 9는 -3임을 어설션합니다.

/// This function divides two numbers.
///
/// # Example #1: 10 / 2 == 5
///
/// ```
/// let result = doctests_exercise::div(...);  // TODO: finish this test!
/// assert_eq!(result, 2);
/// ```
///
/// # Example #2: 6 / 3 = 2
///
/// ```
/// TODO: Write this doctest!
/// ```
///
/// # Panics
///
/// The function panics if the second argument is zero.
///
/// ```rust,should_panic
/// // panics on division by zero
/// TODO: Write this doctest!
/// ```
pub fn div(a: i32, b: i32) -> i32 {
    if b == 0 {
        panic!("Divide-by-zero error");
    }
    a / b
}

/// This function subtracts two numbers.
///
/// # Example #1: 9 - 2 == 7
///
/// ```
/// TODO: Write this doctest!
/// ```
///
/// # Example #2: 6 - 9 == -3
///
/// ```
/// TODO: Write this doctest!
/// ```
pub fn sub(a: i32, b: i32) -> i32 {
    a - b
}

설명서 테스트는 라이브러리 크레이트에만 사용할 수 있으므로 먼저 컴퓨터에 프로젝트를 만들어야 합니다. 터미널에서 다음 명령을 실행하여 이 목표를 달성할 수 있습니다.

$ cargo new --lib doctests_exercise
$ cd doctests_exercise

크레이트의 이름은 이 연습의 첫 번째 할당에서 이미 입력되었기 때문에 함수 이름 앞에 와야 합니다.

이 연습의 전체 버전을 확인하려면 이 Rust Playground 링크를 참조하세요.

계속

연습 - 설명서 테스트 작성

피드백