foundy

버전 포맷

<주번호>.<부번호>.<패치번호>[-<상태코드><수정카운트>]

• 주 번호
  • Major 업데이트
  • 이하 버전 초기화 (e.g. v1.3.5 -> v2.0.0)
• 부 번호
  • Minor 업데이트
  • 호환되는 신규 기능 추가 등
• 이하 버전 초기화 (e.g. v1.3.5 -> v1.4.0)

godrm

1. 스타일/문법 리뷰

1-1 스위프트 API 디자인 가이드라인

https://swift.org/documentation/api-design-guidelines/

• 사용할 때 기준으로 명확하게 작성하는 게 가장 중요한 지향점이다. 메소드나 프로퍼티 같은 개발 요소는 한 번만 선언하고 반복적으로 사용한다. API를 만들 때는 사용하기 명확하고 편하게 만들어야 한다. 설계를 검증할 때 선언 부분을 읽는 것만으로는 부족하다. 그 대신 사용하는 상황에서 맥락에 맞고 명확한 지 늘 고려해야 한다.

• 명확한 표현이 압축한 간결성보다 더 중요하다. 스위프트 코드는 압축해서 간결하게 작성할 수 있지만, 단지 글자수를 줄여서 가장 짧은 코드를 만드는 게 목표는 아니다. 스위프트 코드의 간결성은 자연스럽게 반복적으로 재사용하는 코드(boilerplate)를 줄이는 기능과 강한 타입 시스템의 부수효과로 드러날 뿐이다.

godrm

struct Memory {
    static func dump<T>(variable: inout T) {
        withUnsafePointer(to: &variable) { print($0) }
    }
    
    static func dump(with: UnsafeRawPointer) {
        let address = Int(bitPattern: with)
        print(String(format:"%p", address))
    }