다음을 통해 공유


구조체 및 클래스에 주석 지정

구조체 및 클래스 멤버와 마찬가지로 고정 역할을 하는 주석을 사용 하 여 주석을 달 수 있습니다-함수 시작/바깥쪽 구조를 포함 하 여 매개 변수 또는 결과 값으로 종료 또는 함수 호출에서 true로 간주 됩니다.

구조체와 클래스 주석

주석

설명

_Field_range_(low, high)

범위 (포함)에서 필드인 low 에 high.에 해당 하는 _Satisfies_(_Curr_ >= low && _Curr_ <= high) 해당 pre 또는 post 조건을 사용 하 여 주석이 지정 된 개체에 적용 합니다.

_Field_size_(size)

_Field_size_opt_(size)

_Field_size_bytes_(size)

_Field_size_bytes_opt_(size)

쓸 수 있는 요소 (또는 바이트)으로 지정 된 크기를 가진 필드 size.

_Field_size_part_(size, count)

_Field_size_part_opt_(size, count)

_Field_size_bytes_part_(size, count)

_Field_size_bytes_part_opt_(size, count)

쓸 수 있는 요소 (또는 바이트)으로 지정 된 크기를 가진 필드 size, 및 count 을 읽을 수 있는 요소 (바이트)입니다.

_Field_size_full_(size)

_Field_size_full_opt_(size)

_Field_size_bytes_full_(size)

_Field_size_bytes_full_opt_(size)

요소 (또는 바이트)으로 지정 된 읽기 및 쓰기 가능한 크기를 갖는 필드 size.

_Struct_size_bytes_(size)

구조체 또는 클래스 선언에 적용 됩니다.해당 형식의 유효한 개체에서 지정 하는 바이트 수가 선언 된 형식 보다 더 크게 발생할 수 있음을 나타냅니다 size.예를 들면 다음과 같습니다.

typedef _Struct_size_bytes_(nSize)
struct MyStruct {
    size_t nSize;

};
 

버퍼 크기 (바이트) 매개 변수의 pM 유형 MyStruct * 다음 간주 됩니다.

min(pM->nSize, sizeof(MyStruct))

참고 항목

참조

함수 매개 변수 및 반환 값에 주석 지정

함수 동작에 주석 지정

잠금 동작에 주석 지정

주석 적용 시기 및 위치 지정

내장 함수

모범 사례 및 예제(SAL)

개념

SAL 이해

기타 리소스

C/C++ 코드 오류를 줄이기 위한 SAL 주석 사용