C 함수 프로토타입에 파라미터 이름을 입력하시겠습니까?

C 함수 프로토타입에 파라미터 이름을 입력하시겠습니까?

C에서 함수를 선언할 때는 파라미터의 이름을 쓸 필요가 없는 프로토타입을 설정해야 합니다.종류만 있으면 충분합니다.

     void foo(int, char);

제 질문은 파라미터의 이름도 포함하는 것이 좋은 방법인가 하는 것입니다.

네, 프로토타입에서도 주장의 이름을 짓는 것이 좋은 관행으로 여겨집니다.

일반적으로 모든 프로토타입을 헤더 파일에 저장하게 되며, 헤더는 사용자가 검사할 수 있는 유일한 항목일 수 있습니다.따라서 의미 있는 인수 이름을 갖는 것이 API에 대한 첫 번째 문서 수준입니다.

마찬가지로 기능의 구현 방식이 아닌 기능에 대한 의견도 시제품과 함께 머리글에 실려야 합니다.

잘 쓰여진 헤더 파일이 라이브러리의 가장 중요한 부분일 수도 있습니다!

---

_{흥미로운 것은 차치하고, 주장의 일관성은 구현 세부사항입니다.따라서 구현에서 인수 변수를 변형하지 않는 경우에는const구현 시:}

/* Header file */

/* Computes a thingamajig with given base
 * in the given number of steps.
 * Returns half the thingamajig, or -1 on error.
 */
int super_compute(int base, int steps); 

/* implementation file */

#include "theheader.h"

int super_compute(const int base, int steps)
{
  int b = 2 * base;
  while (--steps) { b /= 8; } /* no need for a local variable :-) */
  return -1;
}

저는 반드시 매개 변수의 이름을 포함하는 것을 추천합니다.라이브러리를 작성하는 경우 라이브러리를 사용하는 사용자는 헤더 파일의 프로토타입에서 함수가 수행하는 작업을 수집할 수 있습니다.고려하다memcpy예를 들어.매개변수의 이름이 없으면 어떤 것이 출처이고 어떤 것이 목표인지 알 수 없습니다.마지막으로, 프로토타입으로 만들기 위해 함수 정의를 복사할 때 이름을 제거하는 것보다 이름을 포함하는 것이 더 쉽습니다.이름을 유지하는 경우 마지막에 세미콜론만 추가하면 됩니다.

일부 IDE 및 편집기는 헤더 파일에서 프로토타입 정보를 꺼내어 입력하는 동안 매개 변수 정보를 힌트로 제공합니다.이름을 사용할 수 있는 경우 코드를 더 빨리 쓰는 데 도움이 되며 일부 버그를 방지하는 데도 도움이 됩니다.

언급URL : https://stackoverflow.com/questions/8174886/put-name-of-parameters-in-c-function-prototypes