Lua Academy · 강의

pcall을 사용한 보호된 호출

pcall로 오류를 안전하게 포착하고 반환 값을 해석합니다.

pcall을 사용한 보호된 호출은(는) CoddyKit의 무료 Lua Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Lua Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Lua Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

pcall 기초

pcall(f, ...)은 보호 모드에서 인수 ...와 함께 함수 f를 호출합니다. f가 성공하면 pcall은 true 뒤에 모든 반환 값을 반환합니다. f에서 오류가 발생하면 pcall은 false 뒤에 오류 메시지를 반환합니다. 어느 경우든 프로그램은 계속 실행됩니다.

local function risky(x)
  if x < 0 then error("negative input: " .. x) end
  return math.sqrt(x)
end

local ok, result = pcall(risky, 9)
print(ok, result)    -- true  3.0

ok, result = pcall(risky, -1)
print(ok, result)    -- false  ...: negative input: -1

특정 오류 잡기

pcall 이후 오류 값의 유형을 확인하여 서로 다른 종류의 오류를 다르게 처리하십시오. 테이블 오류에는 구조화된 데이터가 있고 문자열 오류에는 메시지가 있습니다. 항상 두 경우를 모두 처리하십시오.

local function op(errType)
  if errType == "table" then
    error({code=42, msg="structured error"})
  else
    error("plain string error")
  end
end

local ok, err = pcall(op, "table")
if not ok then
  if type(err) == "table" then
    print("Code:", err.code, "Msg:", err.msg)
  else
    print("String error:", err)
  end
end

성공 시 여러 반환 값

성공하면 pcall은 처음의 true 뒤에 보호된 함수의 모든 반환 값을 반환합니다. 여러 변수를 사용하여 이를 받으십시오.

local function compute(a, b)
  return a + b, a * b, a - b
end

local ok, sum, product, diff = pcall(compute, 6, 4)
if ok then
  print("sum:", sum, "product:", product, "diff:", diff)
  -- sum: 10  product: 24  diff: 2
end

pcall 중첩하기

pcall 호출은 중첩할 수 있습니다. 각 pcall은 독립적인 보호 범위를 만듭니다. 내부 pcall에서 발생한 오류는 외부 pcall이 아니라 내부 pcall이 잡습니다. 이를 통해 대체 전략을 구현할 수 있습니다.

local function tryPrimary()
  error("primary failed")
end

local function tryFallback()
  return "fallback result"
end

local ok, result = pcall(tryPrimary)
if not ok then
  print("Primary failed:", result)
  ok, result = pcall(tryFallback)
end

if ok then print("Got:", result) end  -- fallback result

메서드와 함께 사용하는 pcall

pcall을 통해 메서드(콜론 구문)를 호출하려면 함수와 객체를 첫 번째 인수로 전달하십시오. pcall(obj.method, obj, args...)를 사용하거나 클로저로 감싸면 됩니다.

local obj = {
  x = 10,
  compute = function(self, n)
    if n == 0 then error("zero divisor") end
    return self.x / n
  end
}

-- Pass method + self explicitly
local ok, v = pcall(obj.compute, obj, 2)
print(ok, v)   -- true  5.0

-- Or use a closure
ok, v = pcall(function() return obj:compute(0) end)
print(ok, v)   -- false  ...zero divisor

IO 안전성을 위한 pcall

예상하지 못한 OS 오류를 잡으려면 IO 작업을 pcall로 감싸십시오. 호출자가 실패를 원활하게 처리할 수 있도록 일관된 결과/오류 쌍을 반환하십시오.

local function safeRead(path)
  local ok, result = pcall(function()
    local f = assert(io.open(path, "r"))
    local content = f:read("a")
    f:close()
    return content
  end)
  if ok then return result
  else return nil, result
  end
end

local data, err = safeRead("config.txt")
if data then print("Read", #data, "bytes")
else print("Error:", err)
end

pcall을 사용한 재시도 패턴

pcall을 사용해 오류를 잡으면서 불안정한 작업(네트워크 요청, 파일 쓰기)을 최대 N회까지 재시도하십시오. 실제 코드에서는 재시도 사이에 대기하거나 코루틴을 사용하십시오.

local function retry(fn, maxAttempts)
  local attempts = 0
  while attempts < maxAttempts do
    attempts = attempts + 1
    local ok, result = pcall(fn)
    if ok then
      print("Succeeded on attempt", attempts)
      return result
    end
    print("Attempt", attempts, "failed:", result)
  end
  error("all " .. maxAttempts .. " attempts failed")
end

local n = 0
retry(function()
  n = n + 1
  if n < 3 then error("not ready") end
  return "done"
end, 5)

테이블에 pcall 결과 저장하기

반복문에서 pcall을 사용할 때는 나중에 분석할 수 있도록 결과를 테이블에 저장하십시오. 첫 번째 실패에서 중단하지 않고 모든 항목을 처리하면서 오류를 수집하려는 일괄 작업에 유용합니다.

local jobs = {10, -5, 25, 0, 16}
local results = {}

for _, n in ipairs(jobs) do
  local ok, v = pcall(function()
    if n < 0 then error("negative") end
    return math.sqrt(n)
  end)
  results[#results+1] = {input=n, ok=ok, value=v}
end

for _, r in ipairs(results) do
  if r.ok then
    print(r.input, "->", string.format("%.3f", r.value))
  else
    print(r.input, "-> ERROR:", r.value)
  end
end

pcall과 xpcall 비교

pcall은 오류를 잡지만 오류 값만 제공합니다. xpcall은 호출 스택이 아직 유지된 상태에서 실행되는 메시지 처리기 함수를 지정할 수 있어 호출 스택 추적이 가능합니다. 호출 스택 추적이 필요하면 xpcall을 선택하십시오.

-- pcall: simple, no traceback
local ok1, err1 = pcall(function()
  error("simple error")
end)
print(err1)   -- only the error message

-- xpcall: with traceback handler
local ok2, err2 = xpcall(
  function() error("traced error") end,
  function(e) return debug.traceback(e, 2) end
)
print(err2)   -- full stack trace

pcall 반환 규약

일관된 API의 기반으로 pcall을 사용하십시오. 성공하면 항상 value를 반환하고, 실패하면 nil, errorMessage를 반환하십시오. 함수들을 이 방식으로 구성하면 호출자는 항상 무엇을 예상해야 하는지 알 수 있습니다.

local function loadJSON(path)
  local ok, result = pcall(function()
    local f = assert(io.open(path, "r"))
    local text = f:read("a")
    f:close()
    -- Fake JSON parse for demo
    return {data = text, path = path}
  end)
  if ok then return result
  else return nil, result
  end
end

local data, err = loadJSON("data.json")
if data then print("Loaded:", data.path)
else print("Failed:", err)
end

빠른 확인

보호된 함수가 성공하면 pcall은 무엇을 반환합니까?

복습: pcall

요약:

pcall(f, ...) → true, results... 또는 false, err
첫 번째 반환 값을 확인하여 성공 또는 실패를 판단합니다.
성공하면 true 뒤에 여러 반환 값이 옵니다.
중첩된 pcall에서는 각 pcall이 서로 독립적으로 자신의 오류를 잡습니다.
재시도 패턴: 불안정한 작업에는 pcall을 사용하는 반복문을 활용합니다.
호출 스택 추적이 필요하면 xpcall을 사용합니다.

자주 묻는 질문

“pcall을 사용한 보호된 호출” 강의는 무료인가요?

네 — “pcall을 사용한 보호된 호출” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Lua Academy 강의 전체를 잠금 해제할 수 있습니다. Lua Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“pcall을 사용한 보호된 호출”에서 뭘 배우나요?

pcall로 오류를 안전하게 포착하고 반환 값을 해석합니다. 브라우저에서 직접 실행하는 실습 코드로 Lua Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Lua Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Lua Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“pcall을 사용한 보호된 호출” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Lua Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Lua Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Lua Academy(으)로 돌아가기