기술 문서

Delphi의 LAMBDA와 LET: HotXLS 수식 클로저

셀에는 =NetOf(B2, C2)가 들어 있고, B2는 1250, C2는 0.19를 담고, Excel은 1012.5를 보여 주며, 워크북에는 VBA 모듈도 애드인도 없다. NetOf는 이름 관리자에 산다. 텍스트가 LAMBDA(amount, rate, amount*(1-rate))인 정의된 이름이다. 모든 정의된 이름을 범위나 상수로 취급하는 서버 측 계산기는 여기서 호출할 것을 찾지 못하고 셀은 #NAME?로 돌아온다

이 셀을 제대로 처리하려면 LAMBDA라는 단어를 받아들이는 파서만으로는 모자르다. 고전적인 스프레드시트 평가기는 다섯 종류의 값을 안다. 숫자, 텍스트, 불리언, 오류, 그리고 그것들을 담은 셀에 대한 참조다. LAMBDA는 여섯 번째를 추가한다. 매개변수 이름과 본문, 그리고 쓰인 자리에서 보이던 이름들을 함께 나르는 함수 값이다. LET은 이야기의 나머지 절반이다. 사용자가 이 함수들을 짧은 로컬 이름에 바인딩하고 토큰 몇 개 뒤에서, 흔히 세 계층 깊이로 호출하는 곳이 LET이기 때문이다

함수 이름이 판별되는 세 곳

HotXLS 수식 엔진이 내장 함수가 아닌 이름에 대한 호출을 만나면 고정된 순서로 세 곳을 시도한다. 첫째는 현재 LET 또는 LAMBDA 스코프다. f가 클로저를 담은 로컬 바인딩이면 f(21)이 그것을 적용한다. 둘째는 텍스트가 LAMBDA로 시작하는 워크북 정의된 이름으로, NetOf(1250, 0.19)는 이름의 본문을 컴파일해 두 인자에 적용한다. 셋째는 커스텀 Delphi 함수에 이미 쓰고 있을 수 있는 사용자 함수 핸들러로, HotXLS 수식 엔진의 커스텀 함수에서 설명한다. 셋 모두 통과하지 못했을 때만 셀은 #NAME?이 된다

이 순서가 결정적인 하나의 상황에서 빛을 낸다. 로컬 이름은 철자가 같은 워크북 이름보다 항상 이긴다. 로컬 바인딩이 평범한 숫자를 담고 있을 때조차 그렇다. 이 경우 정의된 이름 탐색은 아예 건너뛰고 호출은 사용자 함수 핸들러로 곧장 가며, 같은 이름의 워크북 LAMBDA는 그 호출에서 영영 물색되지 않는다

Delphi에서 f(21) 같은 미지 함수 이름에 순서대로 시도되는 세 가지 HotXLS 호출 판별 경로 다이어그램: 클로저를 담은 로컬 LET 또는 LAMBDA 스코프 바인딩, RefersTo 텍스트가 LAMBDA로 시작하는 워크북 정의된 이름, 고전적인 사용자 함수 핸들러. 숫자를 담은 로컬 바인딩은 함수로 적용되지 않으며, 사용자 함수 핸들러가 이름을 가져가지 않으면 호출은 #NAME?으로 끝난다
HotXLS는 로컬 스코프를 먼저 시도하고, 다음으로 LAMBDA 정의된 이름, 그다음 고전적인 사용자 함수 핸들러를 시도하며, 클로저를 담지 않은 바인딩의 호출은 거부한다

Delphi 쪽은 짧다. 이름 붙은 함수는 TXLSXDefinedNames.Add로 추가하는 정의된 이름일 뿐이고, 하나의 수식 안에서의 클로저는 등록이 아예 필요 없다:

var
  Book: TXLSXWorkbook;
  Sheet: TXLSXWorksheet;
begin
  Book := TXLSXWorkbook.Create;
  try
    Sheet := Book.Sheets.Add('Model');

    // 인자 두 개짜리 Add = 워크북 스코프, call-by-name이 찾는 바로 그곳
    Book.DefinedNames.Add('NetOf', 'LAMBDA(amount, rate, amount*(1-rate))');

    // 1250 * (1 - 0.19) = 1012.5
    Sheet.Cells[2, 2].Formula := 'NetOf(1250, 0.19)';

    // 하나의 수식 안에서 바인딩되고 적용되는 클로저: 42
    Sheet.Cells[3, 2].Formula := 'LET(double, LAMBDA(x, x*2), double(21))';

    // bump는 base = 100을 캡처; bump(5) = 105, step*2 = 210
    Sheet.Cells[4, 2].Formula :=
      'LET(base, 100, bump, LAMBDA(v, v+base), LET(step, bump(5), step*2))';

    // 후위 적용, 이름 없이: 42
    Sheet.Cells[5, 2].Formula := 'LAMBDA(x, x*2)(21)';

    Book.Recalculate;
    Book.SaveAs('lambda-model.xlsx');
  finally
    Book.Free;
  end;
end;

마지막 셀은 사람들이 잊기 쉬운 형태를 보여 준다. Excel은 인자 목록을 LAMBDA 식 바로 뒤에 붙여 써서 직접 적용하는 것을 허용하고, HotXLS도 LAMBDA(x, x*2)(21)를 같은 방식으로 파싱한다. 파서가 그 뒤에 붙는 인자 목록을 받는 것은 함수를 만들어 낼 수 있는 것, 곧 이름이나 LET·IF 식, 또는 다른 적용 뒤에 한정된다. (1+2)(3)을 쓰면 평가 시점이 아니라 컴파일 시점에 실패한다

클로저가 기억하는 것, 그리고 매개변수가 이기는 이유

HotXLS에서 LAMBDA 식을 평가하면 클로저 값이 나온다. 매개변수 이름, 본문의 사본, 쓰인 시트, 그리고 그 순간 보이던 모든 LET·LAMBDA 바인딩의 스냅샷이다. 앞의 네 번째 셀에서 bump는 base가 이미 100에 바인딩된 상태에서 만들어지므로 클로저는 base = 100을 함께 나른다. bump(5)가 안쪽 LET 안에서 실행될 때 본문은 그 100을 여전히 본다. 안쪽 LET은 이름으로는 base를 전혀 모르는데도

호출은 세 단계로 일어난다. 인자 식이 먼저, 호출자 스코프에서 평가된다. 그다음 캡처된 환경이 쌓이고 그 위에 매개변수가 쌓인 뒤 본문이 평가된다. 탐색은 위에서 아래로 이뤄지므로 rate라는 이름의 매개변수는 rate라는 이름의 캡처 바인딩을 가리고, 캡처 바인딩은 호출자가 우연히 같은 이름으로 바인딩한 것을 가린다. 본문이 반환하거나 실패하면 스코프는 호출이 시작된 지점까지 잘려 나간다

Delphi의 HotXLS LAMBDA 클로저 호출 다이어그램: 클로저 값은 매개변수와 본문, 주변 LET에서 캡처한 base 바인딩을 나르고, 호출은 인자 v = 5보다 먼저 캡처된 환경을 쌓으며, 본문은 105로 평가되고, 스코프 스택은 finally 가드 안에서 진입 표식까지 잘려 나간다
클로저 호출은 인자 바인딩보다 먼저 캡처된 환경을 쌓으며, 매개변수가 바깥 이름을 가리는 것은 바로 이 순서 덕분이다

어떤 바인딩도 설치되기 전에 인자를 평가한다는 것은 세부 사항처럼 들린다. LET(x, 10, f, LAMBDA(x, x+1), f(x*2))를 쓰기 전까지는. 인자 x*2는 바깥쪽 x를 뜻해야 하고 20이 되며 결과는 21이다. 매개변수가 먼저 설치됐다면 인자는 자신이 곧 정의할 매개변수를 읽었을 것이다. 자연스럽게 나오는 규칙은 Excel 사용자가 기대하는 것이다. 이름 붙은 함수가 계산하는 것은 자신의 인자와 쓰인 시점에 캡처한 것에 달려 있고, 호출자의 다른 로컬 이름은 결코 새어 들어오지 않는다

f가 숫자를 담고 있을 때 f(21)은 왜 실패하는가?

클로저가 아닌 것을 담은 로컬 바인딩은 결코 함수로 적용되지 않는다. LET(f, 3, f(21))은 3에 21을 곱하지 않고, f라는 워크북 이름으로 폴백하지도 않는다. 호출은 사용자 함수 핸들러로 넘어가고, 이름을 가져가는 핸들러가 없으면 셀은 #NAME?으로 끝난다. 스프레드시트에는 이 결과가 옳다. 함수 호출을 조용히 곱셈으로 바꿔 버린 오타는 아무도 의심하지 않는 그럴듯한 숫자를 만들어 낼 테니까

후위 적용은 더 엄격하다. 인자 목록 앞에 놓인 것은 무엇이든 평가되고 그 결과가 클로저가 아니면 셀은 #VALUE!를 받는다. 그래서 LET(g, 3, (g)(21))과 LET(g, 3, g(21))은 서로 다른 오류로 실패한다. 스크래치 워크북에서 재현해 볼 수 있는 다른 실패들:

  • 인자 개수 불일치: LET(add, LAMBDA(a, b, a+b), add(1))은 인자 식이 평가되기 전에 #VALUE!를 반환한다
  • 인자 안의 오류는 값으로 이동한다: LET(safe, LAMBDA(x, IFERROR(x, 0)), safe(1/0))에서 #DIV/0!는 x에 바인딩되고 본문 안의 IFERROR가 그것을 0으로 바꾼다
  • 참조는 참조로 남는다: A1 같은 인자는 셀 참조로 본문에 도착하므로, 참조 정체를 신경 쓰는 함수, ISREF를 비롯해, 셀의 값이 아니라 참조를 본다
  • LAMBDA 정의는 최대 253개의 매개변수를 받는다. Excel이 LAMBDA에 대해 문서화한 것과 같은 상한이다
  • 무한 재귀는 멈춘다. 자기 자신을 호출하는 이름 붙은 람다는 평범한 수식 중첩과 마찬가지로 256중첩의 기본 상한을 공유하고, 넘으면 Delphi 스택을 다 쓰지 않고 리소스 한도 오류로 호출이 끝난다
// Log는 여러분의 로깅 루틴이지 HotXLS의 일부가 아니다
procedure ProbeLambdaErrors(Sheet: TXLSXWorksheet; Book: TXLSXWorkbook);
begin
  Sheet.Cells[2, 4].Formula := 'LET(f, 3, f(21))';                       // 핸들러가 없으면 #NAME?
  Sheet.Cells[3, 4].Formula := 'LET(g, 3, (g)(21))';                     // #VALUE!, 후위 적용
  Sheet.Cells[4, 4].Formula := 'LET(add, LAMBDA(a, b, a+b), add(1))';     // #VALUE!, arity
  Sheet.Cells[5, 4].Formula := 'LET(safe, LAMBDA(x, IFERROR(x, 0)), safe(1/0))'; // 0
  Book.Recalculate;
  Log(Sheet.Cells[2, 4].FormattedText);
  Log(Sheet.Cells[3, 4].FormattedText);
  Log(Sheet.Cells[4, 4].FormattedText);
  Log(Sheet.Cells[5, 4].FormattedText);
end;

HotXLS의 LET 바인딩, 중첩과 부분성

HotXLS는 LET을 왼쪽부터 오른쪽으로 평가한다. 각 바인딩은 그보다 앞선 바인딩 전부가 스코프에 있는 상태로 평가되어 쌓이고, 마지막 인자는 완전한 집합 아래에서 평가된다. 그래서 LET(a, 1, b, a+1, LET(c, b*2, c))는 4를 반환하고 안쪽 LET은 a와 b를 모두 본다. 바깥쪽 LET이 끝나면 그 바인딩들은 사라진다. 다음 셀의 형제 수식은 빈 스코프에서 시작한다는 뜻이다

무엇이든 실행되기 전에 두 가지 형태 규칙이 강제된다. LET은 홀수개, 최소 세 개의 인자를 필요로 하므로 LET(a, 1)은 #VALUE!다. 그리고 이름 슬롯은 모두 평범한 이름이어야 한다. LET(A1, 5, A1*2)는 A1이 셀 참조이므로 거부된다. 반면 x나 ab처럼 열 글자 철자와 겹치는 짧은 이름은 LET과 LAMBDA 안에서는 로컬 이름으로 읽힌다. 범위에 대한 바인딩은 범위를 유지하므로 LET(r, A1:A10, ROWS(r))는 10을 반환하고 SUM(r)은 셀들을 더한다

같은 클로저 값이 그것들을 위해 만들어진 헬퍼 함수에도 쓰인다. MAP, REDUCE, SCAN, MAKEARRAY, BYROW, BYCOL이다. MAP(A2:A6, LAMBDA(v, v*2))는 두 배가 된 값 다섯 개를 확산하고, REDUCE(0, A2:A6, LAMBDA(acc, v, acc+v))는 그것들을 하나의 합으로 접는다. 캡처된 환경은 직접 호출에서와 똑같이 그 호출들에도 따라 들어가므로, LET에 바인딩된 rate는 MAP 본문 안에서도 여전히 보인다

쉼표, 세미콜론, 그리고 SaveAs가 쓰는 것

HotXLS 수식 파서는 쉼표와 세미콜론을 인자 구분자로 서로 바꿔 쓸 수 있게 받아들인다. 수식 텍스트는 여러분이 통제하지 않는 곳에서 도착한다. 독일 로케일 머신에서 작성된 지원 티켓, Excel의 정석 쉼표를 쓰는 문서, 수식 문자열을 생성하는 스크립트, 줄곧 세미콜론을 쓰던 예전 HotXLS 코드가 그 원천이다. SUM(A1,A2)와 SUM(A1;A2)는 같은 것으로 컴파일되고, 어느 쪽으로 쓴 LAMBDA도 마찬가지다

인라인 배열 상수가 예외다. 중괄호 안에서 세미콜론은 행 구분자라는 Excel 의미를 유지하므로 {1,2;3,4}는 네 인자 목록이 아니라 2×2 배열이다. 인자 구분자로 세미콜론을 쓰는 수식을 생성한다면 배열 상수는 Excel 구문 그대로 두어라. 그러면 둘이 절대 부딪히지 않는다

Cell.Formula는 여러분이 할당한 텍스트를 반환한다. SaveAs가 XLSX 파일을 쓸 때는 중괄호 밖에서 인자 구분자로 쓰인 세미콜론이 쉼표로 기록된다. OOXML 파일 형식이 수식을 Excel의 쉼표 구문으로 저장하기 때문이고, Excel이 _xlfn. 접두어 아래 저장하는 함수는 나가는 길에 그 접두어를 붙는다. 파일에서 불러온 뒤 손대지 않은 수식은 원래의 XML 텍스트에서 다시 쓰인다

고객 워크북에서 이름 붙은 람다 읽기

Excel에서 작성한 워크북은 LAMBDA 이름을 Excel이 쓰는 그대로 저장한다. 함수 이름에는 _xlfn. 접두어, 매개변수에는 흔히 _xlpm.을 붙여서. HotXLS는 이름을 평가할 때 그 접두어들을 떼어 내지만, TXLSXDefinedName.Formula는 정의 텍스트를 파일이 준 그대로 반환한다. Copy(Name.Formula, 1, 6) = 'LAMBDA'로 쓴 검사는 코드로 만든 이름은 통과시키고 Excel에서 나온 이름은 전부 놓친다. 이 어긋남은 알아채기 쉽지 않다. 계산 값은 어느 쪽이든 옳고 어긋나는 것은 자기 감사 코드뿐이기 때문이다

// IsLambdaDefinition은 직접 추가하는 헬퍼지 HotXLS API가 아니다
function IsLambdaDefinition(const Text: WideString): Boolean;
var
  S: WideString;
begin
  S := UpperCase(Trim(Text));
  if (S <> '') and (S[1] = '=') then
    Delete(S, 1, 1);
  if Copy(S, 1, 6) = '_XLFN.' then
    Delete(S, 1, 6);
  Result := Copy(S, 1, 7) = 'LAMBDA(';
end;

procedure AuditLambdas(const FileName: string);
var
  Book: TXLSXWorkbook;
  Name: TXLSXDefinedName;
  I: Integer;
begin
  // Log는 여러분의 로깅 루틴이다
  Book := TXLSXWorkbook.Create;
  try
    if Book.Open(FileName) = 1 then
    begin
      for I := 0 to Book.DefinedNames.Count - 1 do
      begin
        Name := Book.DefinedNames[I];
        if IsLambdaDefinition(Name.Formula) and (Name.SheetIndex >= 0) then
          Log('Sheet-scoped lambda, not callable by name: ' + Name.Name);
      end;
      Book.Recalculate;
      Log(VarToStr(Book.Sheets[1].Cells[2, 2].Value));
    end;
  finally
    Book.Free;
  end;
end;

그 루프의 스코프 검사는 HotXLS의 call-by-name이 피호출자를 워크북 수준 이름 사이에서 찾기 때문이다. 이름 붙은 함수는 워크북 스코프에 두어라. 시트 스코프 LAMBDA 이름도 FindByName(AName, ASheetIndex)으로 여전히 읽을 수 있지만, 여러 시트에서 호출되는 함수는 워크북에 속한다. 그 뒤에 있는 스코핑 규칙은 정의된 이름과 시트 간 수식에 정리되어 있다

람다를 나중에 고치는 일도 값싸다. TXLSXDefinedName.Formula에 새 텍스트를 할당하면 의존성 그래프가 무효화되어, 다음 Recalculate가 그래프를 다시 만들고 그 함수를 호출하는 셀들을 재평가한다. 그 역학은 증분 재계산과 의존성 그래프에 있다. 호출 없는 =LAMBDA(x, x*2)처럼 맨 클로저로 평가되는 수식을 가진 셀은 캐시 값을 전혀 얻지 못한다. 저장할 숫자나 텍스트가 없기 때문이다. 같은 셀에 Excel은 #CALC!를 표시한다. LAMBDA 지원이 없는 도구에서 열어야 하는 리포트는 Sheet.Cells.ConvertFormulasToValues를 마지막 Recalculate 뒤에 실행해 결과를 얼려라. 캐시 값은 유지하고 수식 텍스트는 떨어뜨린다

LAMBDA와 LET, 헬퍼 함수, 정의된 이름 API는 모두 같은 네이티브 Delphi·C++Builder 라이브러리에서 함께 제공되며, 이 라이브러리는 Excel이 설치되지 않은 환경에서 XLS, XLSX, ODS를 읽고 쓴다. 전체 수식 함수 목록은 HotXLS 스프레드시트 컴포넌트 페이지에 있다