iOS 에 주석 을 이렇게 써 요.
이 글 은 주석 을 어떻게 더 잘 작성 하 는 지 기록 하고 있다.좋 은 주석 은 사용자 가 공식 문 서 를 사용 하 는 것 처럼 사용
option +
하면 사용 설명 을 볼 수 있 습 니 다.매 거 유형 에 대해 서 는 다음 과 같이 할 수 있 습 니 다.
/** HTTP */
typedef NS_ENUM(NSUInteger, ACLApiManagerRequestType) {
ACLApiManagerRequestTypeGet, /**< Get */
ACLApiManagerRequestTypePost, /**< Post */
};
주석 에 사용 되 는 기호 에 주의 하 십시오. 주석 매 거 진 값 과 매 거 진 유형 에 사용 되 는 기호 도 차이 가 있 습 니 다.
속성 에 대해 서 는 다음 과 같이 할 수 있 습 니 다.
@property (nonatomic, copy, readonly) NSString *errorMessage; /**< */
방법 에 대한 설명 은 야옹 신의 플러그 인 VVDocumenter - Xcode 를 설치 하 는 것 을 강력 히 권장 합 니 다.그 다음 에 방법 상부 에 연속 으로 입력
///
을 눌 러 주석 을 삽입 한 다음 에 placeholder 를 삭제 하고 실제 주석 설명 을 작성 합 니 다. 다음 과 같 습 니 다./**
*
*
* @param manager
* @param data
*
* @return
*/
- (BOOL)manager:(ACLAPIBaseManager *)manager isCorrectWithParamsData:(NSDictionary *)data;
그러나 매개 변수 가 없 는 방법 이나 우리 가 생각 하 는 방법의 명명 자체 해석 이 이미 명확 하 다 면 다음 과 같은 설명 을 할 수 있 습 니 다.
/** API base url url */
- (NSString *)methodName;
참고:
Documentation
이 내용에 흥미가 있습니까?
현재 기사가 여러분의 문제를 해결하지 못하는 경우 AI 엔진은 머신러닝 분석(스마트 모델이 방금 만들어져 부정확한 경우가 있을 수 있음)을 통해 가장 유사한 기사를 추천합니다:
다양한 언어의 JSONJSON은 Javascript 표기법을 사용하여 데이터 구조를 레이아웃하는 데이터 형식입니다. 그러나 Javascript가 코드에서 이러한 구조를 나타낼 수 있는 유일한 언어는 아닙니다. 저는 일반적으로 '객체'{}...
텍스트를 자유롭게 공유하거나 복사할 수 있습니다.하지만 이 문서의 URL은 참조 URL로 남겨 두십시오.
CC BY-SA 2.5, CC BY-SA 3.0 및 CC BY-SA 4.0에 따라 라이센스가 부여됩니다.