라이브러리 만들 때 유의사항

라이브러리를 만들 때 어떤 유의사항들이 있을까요...
정리된 것을 찾지 못 해서
제가 그간 개발하면서 느꼈던 라이브러리 만들 때 주의사항을 정리해봅니다.
의견 있으신 분들 댓글 달아주세요~

1. 캡슐화
좀 구질구질하게 만든 라이브러리를 보면 헤더 파일이 무지 많은 경우가 있습니다.
그런 걸 보면 라이브러리를 사용해서 뭔가를 만들어보는 사람들은 한숨부터 납니다.

라이브러리는 헤더 파일 및 심볼이
외부로 노출되어야 할 것과 캡슐화 되어야 할 것을 구분한 후에,
정말 필요한 정보들만 라이브러리 외부로 노출시켜서 보는 사람이 편하게 하는 것이 좋습니다.

외부로 노출이라 함은 헤더 파일에 선언된 것들일 수도 있고,
extern으로 선언된 함수일 수도 있습니다.

2. 오브젝트 묶기
정적 라이브러리를 만들어서 링킹할 때,
아카이브에 있는 심볼들을 오브젝트 단위로 링킹하게 됩니다.

만약 경우에 따라서는 링크할 필요가 없는 심볼들도,
같은 오브젝트에 존재할 경우에 모두 링크되어
바이너리 파일의 크기를 증가시킬 수 있습니다.

따라서 가급적이면 함수 플로우에 연관성이 강한 함수들끼리 같은 오브젝트로 묶고
그렇지 않은 것은 분리하여 놓으면 더 효율적입니다.

3. 명명 규칙
대소문자를 혼합하여 쓴다던지
_로 구분한다던지
명명사전을 이용해서 약어로 표현한다던지
그건 해당 프로젝트의 명명 규칙을 따르면 됩니다.

다만, 라이브러리라 함은 별도의 독립된 실행파일이 아니기 때문에
다른 라이브러리나 오브젝트와 충돌이 생길 수 있습니다.
따라서 해당 라이브러리의 고유한 이름을 함수명, 타입명, define명 등의 prefix에 붙여주는 것이
이러한 충돌을 예방할 수 있는 지름길입니다.
static은 별 상관없겠지만요...

4. 예외처리
물론 예외처리는 모든 프로그래밍에서 중요한 일이겠습니다만,
라이브러리는 자신이 만들고 타인이 땡겨다 쓸 수 있기 때문에 예외처리가 더욱 중요합니다.
절대 라이브러리 중간에 exit문들 넣어서는 안 되며,
적절한 리턴값을 리턴해서 메인 프로그램에서 에러 여부를 판단하도록 해야 합니다.
리턴값을 리턴할 때는 무슨 에러인지를 판단할 수 있도록 잘 구분해주어야 하고요...
그리고 입력값에 대한 검사를 철저히 해야 합니다.
어떤 메인 프로그램이 붙느냐에 따라서 입력을 예상할 수 없는 경우가 많기 때문에,
모든 입력값에 대해서 발생가능한 예외를 체크해야 합니다.
또한 로깅이나, 파이프 출력은 자제하시는 것이 좋습니다.

5. 쓰레드 세이프
라이브러리는 어떤 메인 붙을 지 모르므로,
가급적이면 쓰레드 세이프하게 구현하는 것이 좋습니다.
localtime -> localtime_r
strtok -> strtok_r
이런 것들이 좋은 예가 되겠지요

6. 독립성
라이브러리는 가급적이면 타 라이브러리/프로그램과 의존성을 갖지 않고
독립성을 유지하는 것이 더욱 보편적이고 좋습니다.