Swift Parameter Label 설계를 통한 API 가독성 및 유연성 확보

Context

함수 호출 시 인자의 의미를 명확히 전달해야 하는 API 설계 요구사항 존재. 단순한 파라미터 전달 방식은 호출부의 가독성을 저해하며, 특히 내부 변수명과 외부 레이블의 역할 분리가 필요한 상황 발생.

Technical Solution

• External Parameter Name과 Internal Parameter Name의 분리를 통한 Call Site 가독성 최적화
• 언더바(_) 기호를 활용한 External Label 제거로 Verb-Noun 구조의 자연스러운 문장형 API 설계
• Reserved Word 사용 불가 제약을 해결하기 위한 외부 레이블(예: for)과 내부 변수명(예: number)의 이원화 구조 채택
• Function Overloading 구현 시 파라미터 이름을 식별자로 활용하여 동일 함수명 내 서로 다른 시그니처 정의
• Variadic Parameters 도입을 통한 단일 인자 및 다중 인자 처리의 통합 인터페이스 구축
• Default Parameter Value 설정을 통한 하위 호환성 유지 및 호출부의 설정 유연성 증대