디시인사이드 갤러리

갤러리 이슈박스, 최근방문 갤러리

갤러리 본문 영역

Ada 프로그래밍: 부록: Clair 코딩 스타일 가이드

나르시갤로그로 이동합니다. 2025.08.11 00:28:05
조회 82 추천 0 댓글 0

부록: Clair 코딩 스타일 가이드


들여쓰기: 탭 대신 2개의 공백을 사용하여 들여쓰기를 합니다.

  • 예약어 및 애스펙트: snake_case (전체 소문자)를 사용합니다.
    • 근거: 언어 키워드 및 애스펙트를 사용자가 정의한 식별자와 구별하기 위함입니다.
    • 예시: package, is, begin, end, if, procedure, with, pre, post

프라그마: 프라그마 이름과 해당 컨벤션 식별자에 snake_case (전체 소문자)를 사용합니다.

  • 근거: 다른 언어 키워드 및 속성과의 일관성을 위함입니다. 이는 프라그마 자체(예: import)와 표준 컨벤션 식별자(예: c, intrinsic) 모두에 적용됩니다.
  • 예시: pragma import (c, my_c_func, "my_c_func"), pragma convention (c, My_Data_Type)

공백:

  • 서브프로그램 호출 및 선언: 서브프로그램 이름과 여는 괄호 ( 사이에 단일 공백을 사용합니다.
    • 근거: 서브프로그램 이름을 타입 변환이나 괄호를 사용하는 다른 언어 구조와 시각적으로 구별하여 전체적인 코드 명확성을 향상시키기 위함입니다.
    • 예시 (호출): Clair.Error.get_error_message (errno_code);
    • 예시 (선언): procedure exit_process (status : Integer := EXIT_SUCCESS);
  • 범위 연산자 (..): 범위 연산자의 양쪽에 단일 공백을 사용합니다.
    • 근거: 연산자를 범위 경계와 시각적으로 분리하여 혼동을 방지하고, 특히 부동 소수점 또는 고정 소수점 리터럴과 함께 사용할 때 가독성을 향상시키기 위함입니다.
    • 예시 (타입 선언): range 0.0 .. 100.0
    • 예시 (루프): for i in 1 .. 10 loop

변수, 서브프로그램 및 엔트리: snake_case (밑줄이 있는 전체 소문자)를 사용합니다.

  • 근거: 모든 사용자가 정의한 실행 가능하거나 데이터를 보유하는 식별자에 대해 일관되고 읽기 쉬운 스타일을 유지하기 위함입니다.
  • 예시 (변수 및 서브프로그램): my_variable, get_pid
  • 예시 (엔트리): get_item, put_message ada protected body Buffer is entry get_item (item : out Data) when not is_empty is -- ... end get_item; end Buffer;
  • 반환값 변수: 서브프로그램의 반환값, 특히 상태 코드(예: 0, -1)를 담는 변수에는 retval 사용을 선호합니다.
    • 근거: 이는 result 식별자와의 잠재적 충돌을 피하는 널리 알려진 관례입니다. 특정 데이터를 나타내는 반환값의 경우 bytes_written, new_fd와 같이 더 설명적인 이름을 사용합니다.
    • 예시: retval := dlfcn_h.dlclose (self.handle);

속성: snake_case (전체 소문자)를 사용합니다.

  • 근거: 언어에서 정의한 속성을 사용자가 정의한 타입 및 서브프로그램과 구별하기 위함입니다.
  • 예시: errmsg'length, c_path'address

타입, 서브타입, 예외 및 보호 객체:

  • 단일 단어 식별자에는 Pascal_Case를 사용합니다.
    • 근거: File과 같은 패키지 내에서 Descriptor와 같은 이름은 File.Descriptor로 사용될 때 자명합니다. File.File_Descriptor와 같이 불필요한 접두사를 추가하면 가독성을 해칠 수 있습니다.
    • 예시: Descriptor, Flags, Object
  • 여러 단어로 된 식별자에는 Pascal_Case_With_Underscores를 사용합니다.
    • 근거: 여러 단어로 된 타입 이름 내의 단어들을 명확하게 구별하여 가독성을 향상시키기 위함입니다.
    • 예시: Library_Load_Error, Symbol_Lookup_Error

상수:

  • 컴파일 타임 상수: UPPER_CASE_WITH_UNDERSCORES를 사용합니다. 이 규칙은 표준 라이브러리의 상수를 포함한 모든 정적 상수에 적용됩니다.
    • 근거: 정적인 고정 값을 다른 모든 식별자와 명확하게 구별하기 위함입니다.
    • 프로젝트 정의 예시: EXIT_SUCCESS, MAX_BUFFER_SIZE
    • 표준 라이브러리 예시: System.NULL_ADDRESS, Interfaces.C.NUL, Interfaces.C.Strings.NULL_PTR
  • 런타임 상수: snake_case (변수처럼)를 사용합니다.
    • 근거: 서브프로그램 내에서 동적 값(예: 매개변수)으로 초기화되는 상수에 사용됩니다. 이를 '읽기 전용 변수'로 취급합니다.
    • 예시: final_message : constant String := "Error: " & message;

패키지: Pascal_Case를 사용합니다.

  • 예시: Clair.Process
  • 예외: 두 글자로 구성된 Dl의 경우 DL로 표기합니다. (예: Clair.DL, Clair.Dl Clair.D1처럼 보일 수 있음).

표준 라이브러리 명명 규칙:

  • Interfaces.C: Interfaces.C 패키지 및 그 하위 패키지의 타입과 서브프로그램은 C 표준 라이브러리의 명명 규칙과 일치하도록 snake_case를 사용해야 합니다. 이 패키지의 상수는 컴파일 타임 상수에 대한 전역 UPPER_CASE 규칙을 따릅니다.
    • 근거: Ada와 C 간의 명확하고 일관된 정신적 매핑을 유지하면서 프로젝트의 모든 상수가 균일한 모양을 갖도록 보장하기 위함입니다.
    • 예시 (타입/서브프로그램): Interfaces.C.int, Interfaces.C.char_array, Interfaces.C.Strings.chars_ptr
    • 예시 (상수): Interfaces.C.NUL, Interfaces.C.Strings.NULL_PTR


추천 비추천

0

고정닉 0

0

댓글 영역

전체 댓글 0
본문 보기

하단 갤러리 리스트 영역

왼쪽 컨텐츠 영역

갤러리 리스트 영역

갤러리 리스트
번호 제목 글쓴이 작성일 조회 추천
설문 존재만으로도 웃음주는 최고의 '웃수저' 스타는? 운영자 25/08/25 - -
이슈 느린 여행으로 삶의 속도를 찾는 유튜버 꾸준 운영자 25/08/26 - -
AD MD's pick 상반기 인기 노트북 운영자 25/08/26 - -
2880812 SI 갈까 생각하는 사람들은 봐라 [1] 프갤러(180.71) 08.12 382 2
2880809 챗gpt 플러스랑 제미나이 프로 써본 사람?? 프갤러(112.219) 08.12 67 0
2880808 개발 좀 하다보면 착각하기 딱 좋음 [2] ㅇㅇ갤로그로 이동합니다. 08.12 141 0
2880807 개발이 재밌다고하는 새끼들 특징이 뭐냐면 [2] ㅇㅇ갤로그로 이동합니다. 08.12 116 0
2880805 고졸 앰생 입장에선 개발자가 최선의 선택인듯 [2] 프갤러(106.101) 08.12 96 0
2880802 게임 메모리 핵 같은거 루도그담당(211.184) 08.12 80 0
2880800 음지 개발자들 돈 잘버냐?? [11] ㅇㅇ갤로그로 이동합니다. 08.12 155 0
2880794 작업 먹튀당했네 [5] ㅆㅇㅆ(124.216) 08.12 112 0
2880793 나이든 개발자의 이상한 고집은 해결할 방법이 없다 ㅇ ㅅㅇ.. 프갤러(211.36) 08.12 72 0
2880791 사람들이 죽고 있었다. 윤대통령은 반성해야 한다. 넥도리아(220.74) 08.12 65 0
2880790 C#이나 C++ 쓰는 분야 뭐 있으려나 [2] ㅇㅇ갤로그로 이동합니다. 08.12 144 0
2880787 저 odd 2개인데, 하나는 예전에 모듈 설치해서 고치고, 분해하다가 넥도리아(220.74) 08.12 53 0
2880785 백앤드 입문 루비 온 레일즈로 해도됨? [4] 프갤러(116.45) 08.12 100 0
2880784 이번 광복절 연휴 때 [3] 아스카영원히사랑해갤로그로 이동합니다. 08.12 101 0
2880783 난 일자리 없다는말 못믿겟던데 프갤러(106.101) 08.12 87 0
2880782 단순 퍼블리싱속도면 C#윈폼이 웹개발떡바름 네오커헠(58.225) 08.12 118 0
2880780 개발자는 의사들처럼 파업안하냐 [5] 프갤러(125.182) 08.12 228 1
2880779 범죄자 윤미향 위안부할머니들 돈 횡령 반환 안해 ♥냥덩이♥갤로그로 이동합니다. 08.12 116 0
2880778 냥덩세컨드!!! ♥냥덩이♥갤로그로 이동합니다. 08.12 66 0
2880777 점저는 컨디션 일정따라 무겁게도 가볍ㄱ도 ♥냥덩이♥갤로그로 이동합니다. 08.12 64 0
2880776 아침은 가볍게라도 꼭 머거야함 ♥냥덩이♥갤로그로 이동합니다. 08.12 72 0
2880775 게임엔진 없이 게임 개발 <<< 진짜 먹히는 프로젝트냐 [3] 민뚜색갤로그로 이동합니다. 08.12 118 0
2880774 이거 진짜 맛잇음 ♥냥덩이♥갤로그로 이동합니다. 08.12 64 0
2880772 나 이번이 막학기인데 진짜 취업 ㅈ된 듯... [2] ㅇㅇ(58.235) 08.12 208 0
2880771 백엔드 개발은 일종의 쿠팡물류창고같은거임 [1] 네오커헠(58.225) 08.12 151 0
2880769 코테 문제 사이트 요즘 뭐가 좋아? [3] ㅇㅇ갤로그로 이동합니다. 08.12 371 0
2880768 ❤✨☀⭐⚡☘⛩나님 시작합니당⛩☘⚡⭐☀✨❤ ♥냥덩이♥갤로그로 이동합니다. 08.12 66 0
2880767 나님 왤케 특별한걸깡? ♥냥덩이♥갤로그로 이동합니다. 08.12 65 0
2880766 윈도우ui개발에서 중요한건 xaml같은 퍼블리싱이아님 네오커헠(211.234) 08.12 115 0
2880765 김건희를 보면 한녀들의 표독한 뒷모습을 알 수 있다 [5] 아스카영원히사랑해갤로그로 이동합니다. 08.12 124 0
2880763 프갤 글젠이 처참하군요 [5] 루도그담당(211.184) 08.12 104 0
2880762 자러 감 잇다바 바바이~ ㅇㅅㅇ// 헤르 미온느갤로그로 이동합니다. 08.12 60 0
2880761 요즘 asp.net도 vscode로 가르치더라 [4] 헬마스터갤로그로 이동합니다. 08.12 115 0
2880759 다리 몰카.ㅇㅅㅇ [1] 헤르 미온느갤로그로 이동합니다. 08.12 89 0
2880758 요즘 신입들 실력 어떰? [4] ㅇㅇ갤로그로 이동합니다. 08.12 235 0
2880757 태연 ㅇㅅㅇ 헤르 미온느갤로그로 이동합니다. 08.12 68 0
2880756 하루 한 번 헤르미온느 찬양 헤르 미온느갤로그로 이동합니다. 08.12 64 0
2880754 위안부 할머니들을 등쳐먹은 범죄자 극좌 윤미향 ♥냥덩이♥갤로그로 이동합니다. 08.12 85 0
2880753 얘들아 깃헙 기여부탁행 [1] (119.202) 08.12 94 0
2880752 국제범죄조직 짱깨에 영혼을 판 친짱매국좌파들 ♥냥덩이♥갤로그로 이동합니다. 08.12 74 0
2880734 선선하구낭 ♥냥덩이♥갤로그로 이동합니다. 08.12 59 0
2880715 ❤✨☀⭐⚡☘⛩나님 시작합니당⛩☘⚡⭐☀✨❤ ♥냥덩이♥갤로그로 이동합니다. 08.12 75 0
2880703 Ada 프로그래밍 명저를 만들 겁니다. [1] 나르시갤로그로 이동합니다. 08.12 95 0
2880699 원점으로 되돌아가 Ada 책 목차 작성부터 다시하고 있습니다. 나르시갤로그로 이동합니다. 08.12 66 0
2880689 Ada 프로그래밍: 4.2.6 고급 반복자: 간략한 개요 [1] 나르시갤로그로 이동합니다. 08.12 110 0
2880687 Ada 프로그래밍: 4.2.5 병렬 루프 (Ada 2022) 나르시갤로그로 이동합니다. 08.12 102 0
2880685 Ada 프로그래밍: 4.2.4 루프 이름짓기 나르시갤로그로 이동합니다. 08.12 71 0
2880683 Ada 프로그래밍: 4.2.3 for 루프 나르시갤로그로 이동합니다. 08.12 112 0
2880678 vscode가 심각한 버그가 많구나 나르시갤로그로 이동합니다. 08.12 97 0
2880667 GPT 5 모델도 아첨이 너무 심하다 [1] ㅆㅇㅆ(124.216) 08.12 97 0
뉴스 김연아♥ 고우림, 안타까운 소식…“회복 최우선” 디시트렌드 08.26
갤러리 내부 검색
제목+내용게시물 정렬 옵션

오른쪽 컨텐츠 영역

실시간 베스트

1/8

뉴스

디시미디어

디시이슈

1/2