도구
로그인
한국어

코드 배우기Swift

Swift 접근 제어

Swift 6.4 기준

open·public·internal·fileprivate·private 가 어디서 보이는지 표와 예제로 익혀요.

한 줄 뜻

형식과 멤버가 어디까지 보일지 정하는 것이에요. Swift 는 형식 안, 파일, 모듈(앱이나 꾸러미의 target 하나), 다른 모듈 순으로 다섯 단계를 둬요.

왜 필요한가

메모장의 글 배열이 열려 있으면 화면 코드가 잠금 검사를 건너뛰고 붙여 넣어요. 라이브러리라면 사용하는 사람이 속 배열에 기대는 순간, 그 배열을 다른 꼴로 바꿀 수 없게 돼요.

밖에 필요한 것만 public 으로, 앱 안에서만 사용하는 것은 기본 internal 로, 파일이나 형식 안 도우미는 fileprivate·private 으로 두면 고칠 때 영향이 미치는 곳이 좁아져요.

일상 비유

아파트를 떠올려 보세요. 내 방 서랍(private)은 나만, 우리 집 거실(fileprivate)은 식구만, 단지 놀이터(internal)는 주민만 사용해요. 상가(public)는 누구나 들어오고, 그중 세를 줘서 다른 사람이 꾸며도 되는 가게(open)도 있어요.

예제 코드

main.swift · 44줄
let book = Notebook(owner: "Yuna")book.write("buy milk")book.write("call grandma")book.lock(pin: "0428")book.write("secret plan")print(book.preview())print("pages: \(book.pageCount), locked: \(book.isLocked)")print(peek(book)) public final class Notebook {    public let owner: String    public private(set) var pageCount = 0    private var pages: [String] = []    fileprivate var pin: String?     var isLocked: Bool {        pin != nil    }     public init(owner: String) {        self.owner = owner    }     public func write(_ text: String) {        guard !isLocked else {            print("locked: '\(text)' not saved")            return        }        pages.append(text)        pageCount += 1    }     func lock(pin: String) {        self.pin = pin    }     public func preview() -> String {        pages.joined(separator: " / ")    }} fileprivate func peek(_ book: Notebook) -> String {    "\(book.owner) set a pin: \(book.pin != nil)"}

어디서 보이나(모듈 = 앱이나 꾸러미의 target 하나)

접근 수준같은 형식 안같은 파일같은 모듈다른 모듈에서 사용하기다른 모듈에서 물려받기·override
openOOOOO
publicOOOOX
internalOOOXX
fileprivateOOXXX
privateOXXXX

아무것도 사용하지 않으면 internal 이에요. private 은 같은 파일 안이라면 그 형식의 extension 에서도 보여요. Swift 5.9 부터는 같은 꾸러미 안 모듈끼리만 여는 package 도 있어요.

언제 사용하나

  • 라이브러리 밖에 내보일 API 는 public, 밖에서 물려받아 고쳐 쓰라고 연 class 만 open
  • 앱 코드 대부분은 아무것도 안 적은 internal 이면 충분해요
  • 형식 속 상태는 private, 같은 파일의 도우미 함수끼리 나눌 것은 fileprivate
  • 읽기는 열고 쓰기만 닫을 때는 public private(set) 처럼 짝으로

한 앱 안에서는 public 과 internal 의 차이가 거의 안 보여요. 차이는 꾸러미를 라이브러리로 나눠 다른 모듈에서 import 할 때 드러나요.

public 형식 안의 멤버도 따로 public 을 적어야 밖에서 보여요. 형식만 열고 멤버를 안 열면 밖에서는 빈 상자처럼 보여요.

자주 하는 실수

private 속성을 밖에서 읽음

private 은 그 형식(과 같은 파일의 extension) 안에서만 보여요. 밖에 알려 줄 값이 있으면 pageCount 처럼 따로 읽기 문을 열어요.

틀린 코드

let note = Notebook(owner: "Kai")print(note.pages.count)

Swift 컴파일러가 내는 오류error: 'pages' is inaccessible due to 'private' protection level

고친 코드

let note = Notebook(owner: "Kai")print(note.pageCount)

실행하면0

public 메서드가 internal 형식을 받음

밖에서 pin 을 부를 수 있어도 Sticker 를 만들 수 없으면 소용이 없어서 컴파일러가 막아요. 매개변수 형식도 같은 수준으로 열어요. public struct 는 칸마다 받는 init 이 저절로 public 이 되지 않아서 직접 적어요.

틀린 코드

let board = Board()board.pin(Sticker(text: "hi")) struct Sticker {    let text: String} public final class Board {    private var stickers: [Sticker] = []     public func pin(_ sticker: Sticker) {        stickers.append(sticker)    }}

Swift 컴파일러가 내는 오류error: method cannot be declared public because its parameter uses an internal type

고친 코드

let board = Board()board.pin(Sticker(text: "hi"))print(board.count) public struct Sticker {    public let text: String     public init(text: String) {        self.text = text    }} public final class Board {    private var stickers: [Sticker] = []     public var count: Int {        stickers.count    }     public func pin(_ sticker: Sticker) {        stickers.append(sticker)    }}

실행하면1

struct 에 open 을 붙임

open 은 "다른 모듈에서 물려받고 덮어써도 된다"는 뜻이라 class 와 그 멤버에만 붙어요. struct 는 물려받기가 없어서 가장 넓게 열어도 public 이에요.

틀린 코드

print(Page(title: "cover").title) open struct Page {    let title: String}

Swift 컴파일러가 내는 오류error: only classes and overridable class members can be declared 'open'; use 'public'

고친 코드

print(Page(title: "cover").title) public struct Page {    public let title: String}

실행하면cover

확인 문제

문제 1

접근 수준을 하나도 안 적은 메서드는 어떤 수준일까요?

답과 까닭 보기

답: 2. internal internal 이에요. 같은 모듈(앱 하나, 꾸러미의 target 하나) 안에서는 어디서나 보이고, 다른 모듈에서는 안 보여요.

문제 2

잠근 다음에 글을 써 봤어요. 마지막 줄은?

let note = Notebook(owner: "Ko")note.lock(pin: "1")note.write("hi")print(note.pageCount)

답과 까닭 보기

답: 1. 0 잠긴 메모장은 write 의 guard 에서 걸러져요. 쪽수는 0 그대로이고, 거절 글이 먼저 한 줄 찍혀요.

자주 묻는 것

아무것도 사용하지 않으면 어떤 범위인가요?

internal 이에요. 같은 모듈, 곧 앱 하나나 꾸러미의 target 하나 안에서는 어디서나 보이고 다른 모듈에서는 안 보여요.

open 과 public 은 무엇이 다른가요?

둘 다 다른 모듈에서 사용할 수 있어요. open 은 다른 모듈에서 물려받고 덮어쓰기까지 허락하고, public 은 사용하기만 허락해요. open 은 class 와 그 멤버에만 붙어요.

private 과 fileprivate 은 어떻게 다른가요?

private 은 그 형식(과 같은 파일 안의 그 형식 extension) 안에서만 보여요. fileprivate 은 같은 파일이면 다른 형식이나 함수에서도 보여요.