생각나는대로 수시로 정리하고 있습니다.
이름을 지을 때는 명사, 도아, 복수, 과거 시제 등에 주의하세요. 객체지향에서 클래스 이름은 명사, 함수는 동사로 지으세요.
사용해선 안 되는 것
get / set
접근자(getter / setter) 속성에 많이 사용됩니다. 반대로 임의로 사용할 경우 헷갈릴 수 있습니다. get이라고 적혀 있으면 가벼운 처리로 생각하기 때문에, 중요한 부분에 사용할 땐 get / set 이외의 걸 생각해 보세요.
load, save, commit, store, enable, disable,
fetch, register, configure, add, etc ...
check
의미가 너무 넓어서 무엇을 한다는 건지 알 수가 없습니다. 구체적으로 무엇을 하는지 깊숙이 생각하세요.
isNull, isEmpty, isNullOrEmpty, isValid, canSave, canClose,
hasSaved, hasChanged, exists, contains, etc ...
change
무엇을 어떻게 변경하는지 몰라요. check 처럼 구체적으로 생각하세요. 예를 들어, isChanged 플래그를 변경하는 Change 함수처럼요.
xxxManager / xxController
이런 이름을 붙이면 클래스가 커집니다. 단일 책임의 원칙에 입각하여 클래스를 설계하세요. UNIX 철학도 "Small is beautiful"입니다.
xxxType, xxxData, xxxItem, xxxInfo
중복되기 쉽습니다. Type, Data, Item, Info를 사용해도 의미가 통하지 않을 수 있습니다.
사용하지 않는 편이 좋은 것
compare
편리한 경우도 있지만, 비교한 결과를 어떻게 할 것인지 알 수가 없습니다. 다른 동사를 검토해 보세요.
exists, contains, equals, isSmall, max min, etc ...
toggle
전환, 교체. 전환 상태가 어떤지 알기 어렵습니다.
turnOn, turnOff, switchOn, switchOff, etc ...
짝을 이루는 단어
comment out / uncomment
주석으로 주석을 제거합니다. comment out은 into a comment 의미로 comment뿐이라면 코멘트, 메시지 의미가 됩니다.
add / remove
추가, 삭제한다.
리스트 등에 값을 넣는 경우에도 사용합니다.
특히 끝에 추가하는 경우 append, 앞에 추가할 경우 prepend를 사용합니다.
Add A to B는 A는 B에 넣는다.
Remove A from B는 B에서 A를 제거합니다.
start / stop
시작, 중지한다.
정지 상태에서 움직이기 시작한 느낌이 start.
중간에도 사용합니다.
또는 명사로 시작, 종료를 의미하며, 명사라면 start / end가 있습니다.
begin / end
시작하고 끝낸다.
첫 걸음을 내딛는 느낌이 begin.
시작 밖에 사용할 수 없습니다.
C언어에서 관례적으로 begin은 end를 독점합니다.
first / last
시작과 마지막.
간단한 시퀀스의 경우와 수를 세는 경우 first를 사용합니다.
셀 수없는 경우 beginning를 사용합니다.
min / max
최소, 최대.
top / last
시작, 끝.
순위 및 수준을 나타낼때는 top을 사용합니다.
head / tail
머리, 꼬리에서 변화가 있는 시작과 끝.
파일의 시작 부분과 끝을 나타내는 데 씁니다.
header / footer
머리글, 바닥 글.
본문을 나타내는 경우는 text와 body가 사용됩니다.
top / bottom
맨 위, 맨 아래.
up / down
위로 아래로.
upper case / lower case
대문자, 소문자.
wide / narrow
넓은, 좁은을 나타냄.
full-width와 half-width에서도 사용.
two-byte character와 one-byte character에서 2바이트 문자와 1바이트 문자.
under / over
미만, 초과.
or under / and over
이하, 이상.
greater than 라든지 not less than 등 다수의 표현법이 있습니다.
go / back
이전, 뒤로.
previous / next
이전 다음.
동사로 사용하려면 goNext 등.
forward / backward
앞으로, 뒤로.
foreground / background
전경 배경.
프로그래밍에서는 사용하지 않지만 middle-ground라는 중간 의미도 있습니다.
push / pull
넣는다, 당긴다.
git 명령에서 사용되고있다.
git push와 반대의 동작은 git pull 대신 git fetch가 됩니다.
push / pop
상자에 넣는다, 꺼낸다.
스택에 사용합니다.
enqueue / dequeue
대기열에 추가 대기열에서 꺼낸다.
queue는 대기열의 의미.
before / after
적용 전 적용 후.
parent / child / children / sibling / self
부모, 자식 아이들, 형제, 자신.
XML이나 Tree의 Node를 나타내는 경우에 사용합니다.
ancestors / descendants
조상, 자손.
대부분 복수형으로 사용합니다.
git 기록 등.
do / undo / redo
실행 취소, 다시 실행.
open / close
파일이나 소켓을 열고 닫습니다.
delete / restore
파일을 삭제 복원합니다.
store / restore
저장, 복원합니다.
backup / restore
백업, 복원합니다.
connect / disconnect
회선을 연결, 끊기입니다.
source / destination
송신원, 송신.
input / output
입력, 출력한다.
장치 (화면이나 키보드 등)에서의 입출력.
import / export
밖으로, 안으로 내보낸다/받는다.
download / upload
다운로드, 업로드한다.
request / response
요구, 희망, 요청.
응답 반응 응답.
request / respond
요청, 응답한다.
fetch / post
네트워크를 통해 데이터를 가지고 오는 경우 fetch 사용할 수 있습니다.
post 대신 send가 허용 됩니다.
serialize / deserialize
직렬화 복원한다.
메모리에 있는 데이터를 파일 형식으로 변환하는 과정입니다.
read / write
파일이나 포트를 판독, 기록합니다.
read는 읽기 행위 자체를 가리킵니다.
save / load
저장, 로드.
읽어오기(설정)까지 load.
set / unset
설정 해제한다.
reset 다시 설정 세트 다시.
lock / unlock
잠금 해제한다.
attach / detach
묶기, 분리.
suspend / resume
중단, 복귀.
enable / disable
활성화, 비활성화
activate / deactivate
활성화, 비활성화
show / hide
표시, 비표시.
visible / hidden
표시, 숨기기
hidden이 invisible보다 명확합니다.
valid / invalid
유효한 잘못된.
validation 검증의 의미.
collapse / expand
축소 확장.
트리를 조작할 경우에 사용합니다.
normal / abnormal
정상, 이상.
명확한 기준이 있고, 맞다, 틀리다 구분합니다.
normal / error
정상, 이상.
regular / irregular
일정한 불규칙적인. 일상적이고 비일상적인.
일정한 반복 패턴이 거기에 해당하는지.
general / special
일반, 특별.
general 전반적인 세상 일반 느낌.
ordinal / special
평범한 특별한.
common / special
공통의 고유.
common / personal
공용 개인.
common settings에서 공통 설정.
shared는 소유자가 있지만, 나누어 사용한다는 의미에서의 공유.
common / uncommon
흔한, 평범하지 않음
available / unavailable
이용 가능 이용 불가 또는 사용 가능 입수 불가.
success / failure
성공, 실패.
success와 error를 사용하는 경우.
OK와 NG는 일본식 영어이므로 사용 불가.
accept / refuse
수락 또는 거부.
allow / deny
허용, 거부.
파일 시스템의 권한 및 네트워크 관련이 실패하면 denied라고 말합니다.
host / guest
호스트, 손님.
손님을 부르는 쪽이 호스트.
손님은 손님.
server / client
서버 클라이언트.
서비스를 제공하는 측이 서버.
의뢰하는 것이 클라이언트.
댓글