한 줄 뜻
형식과 멤버가 어디까지 보일지 정하는 것이에요. 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)"}
Swift 코드는 이 화면에서 실행하지 않아요. 고친 코드는 내 컴퓨터에서 main.swift 로 저장하고 swiftc 로 컴파일해 돌려 보세요.
어디서 보이나(모듈 = 앱이나 꾸러미의 target 하나)
| 접근 수준 | 같은 형식 안 | 같은 파일 | 같은 모듈 | 다른 모듈에서 사용하기 | 다른 모듈에서 물려받기·override |
|---|
open | O | O | O | O | O |
|---|
public | O | O | O | O | X |
|---|
internal | O | O | O | X | X |
|---|
fileprivate | O | O | X | X | X |
|---|
private | O | X | X | X | X |
|---|
아무것도 사용하지 않으면 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 은 같은 파일이면 다른 형식이나 함수에서도 보여요.