Delphi export는 계좌 번호 123456789012를 숫자로 저장합니다. 넉넉한 Excel 열은 1.23457E+11을 보여 주는 반면 =A1&""는 열두 자리를 모두 돌려주죠. Excel은 숫자를 텍스트로 바꿀 때 규칙 둘을 씁니다. General 표시에는 열한 글자, formula 안에서는 유효숫자 열다섯입니다. 그래서 HotXLS export는 첫째를 FormattedText에서 읽고 둘째는 formula 엔진으로 만듭니다
General format은 몇 글자까지 허용하는가
열한 글자이며, 마이너스 부호는 세지 않습니다. ECMA-376 Part 1 §18.8.30은 애플리케이션이 "소수점을 포함해 최대 11자리까지 전체 숫자를 표시하려 노력해야 한다"고 말하고, floating point 규칙은 이를 더 정확히 적습니다. "셀 표시의 최대 전체 길이는 11이며 음수 부호는 포함하지 않는다"죠. 표준은 지수 형식으로 전환하는 네 조건을 스케치한 뒤 거기서 멈춥니다. 반올림은 열려 있고, 작은 수의 전환 지점도 열려 있습니다. 아래의 동작은 넉넉한 열에서 Excel이 보여 주는 것이며, HotXLS가 셀의 표시 텍스트와 TEXT(A1, "General")에서 재현하는 것이기도 합니다:
- 정수부가 열한 글자 안에 들어맞는 숫자는 고정 표기법에 머물며 소수를 포기합니다.
12345.6789012345는12345.6789로 보이고,12345678901.5는12345678902로 반올림됩니다 - 열두 자리 정수부는 들어맞지 않으므로
123456789012는1.23457E+11이 됩니다. 지수가 들어갈 자리를 남기려고 가수를 반올림한 것입니다 - 1 미만의 숫자는 여섯 자리 scientific 형태만큼의 유효숫자를 보여 주는 동안 고정 표기법에 머뭅니다.
0.00012345678은0.000123457으로 표시되지만,0.0000123456789는1.23457E-05가 됩니다 - 지수는 언제나 부호와 최소 두 자리를 실어 나르므로 1020은
1E+20으로 표시됩니다
부호는 예산 바깥에 앉습니다. -12345678901은 마이너스 부호 뒤의 열한 자리를 모두 보여 주어 모두 열두 글자인 반면, -123456789012는 -1.23457E+11이 됩니다. 할당하는 Variant 타입은 결과를 바꾸지 않습니다. Excel은 모든 숫자 셀 값을 double로 지니고, HotXLS는 Integer, Int64, Currency, Double 값을 같은 열한 글자 규칙으로 보내므로 Cells[1, 1].Value := Int64(123456789012)도 1.23457E+11로 표시됩니다. 이 규칙은 custom format에도 이어집니다. section의 literal 텍스트는 General 결과 주위에 더해지므로 General" kg"은 같은 숫자를 1.23457E+11 kg으로 보여 줍니다. 비어 있거나 literal만 있는 section의 format은 자기 규칙을 따르며 숫자를 아예 숨길 수도 있습니다
하나 더 있는 한계는 어느 라이브러리 밖에 있습니다. 표준은 "표시의 최적 방법은 이용 가능한 셀 폭에 기반한다"를 더하고, 기본 폭 열에서 Excel은 표시하는 머신의 font metrics에 따라 1.2E+11까지 또는 # 줄까지 더 짜냅니다. 파일을 만드는 서버에는 화면 위의 열이 없으므로, HotXLS는 그 마지막 단계를 셀을 그리는 이에게 맡깁니다. 비교하기 전에 열을 넓히세요. 그렇지 않으면 Excel의 폭 fallback을 General 규칙과 잰 것이 되고, 둘은 열보다 긴 모든 값에서 어긋납니다
formula 텍스트는 유효숫자 열다섯을 지킵니다
숫자가 formula 안에서 텍스트가 되는 순간 — & 연산자, CONCAT, TEXTJOIN, LEN, LEFT — 다른 규칙이 넘겨받습니다. ECMA-376 §18.17은 formula 문법은 정의하지만 이 단계의 number-to-text 형식은 정의하지 않으므로, Excel의 출력이 유일한 참조입니다. Excel은 유효숫자 열다섯으로 반올림하고, 부호를 빼고 최대 스무 글자에 들어맞는 한 평범한 위치 표기법으로 씁니다. 그래서 =1/3&""는 0.333333333333333, 즉 3이 열다섯 개를 돌려줍니다. =1E+19&""는 10000000000000000000을, =1E-18&""는 0.000000000000000001을 돌려주죠. 스무 글자를 넘으면 텍스트는 격자가 쓰는 것과 같은 부호 있는 두 자리 지수의 scientific 표기법으로 갈아탑니다. 1E+20, 1.23456789012345E-05이죠. 구분자는 언제나 마침표입니다. HotXLS는 프로그램이 돌아가는 머신의 regional settings를 참조하지 않고 formula를 평가하므로, &로 만든 lookup 키는 영어 서버와 독일어 서버에서 똑같이 나옵니다
formula 텍스트에는 Excel 스스로가 머신에 의존하는 구석이 하나 있습니다. CHAR와 CODE는 127을 넘는 숫자를 Excel이 돌아가는 컴퓨터의 ANSI 코드 페이지로 맵핑하므로, =CHAR(128)은 서유럽 Windows 설치에서는 유로 부호이고 다른 코드 페이지에서는 다른 문자입니다. Delphi 서비스는 최종 독자가 어느 코드 페이지를 쓰는지 알 수 없습니다. HotXLS는 그 코드들을 모든 머신에서 서유럽 코드 페이지인 Windows-1252로 평가하므로, =CHAR(150)은 어느 서버에서든 en dash를 줍니다. 워크북이 다른 코드 페이지를 겨냥한다면 그 문자들은 Delphi에서 계산해 텍스트로 저장하세요
FloatToStr는 어느 규칙도 따르지 않습니다
| 값 | General 표시 / TEXT | formula 텍스트(&"") | Delphi FloatToStr |
|---|---|---|---|
| 123456789012 | 1.23457E+11 | 123456789012 | 123456789012 |
| 1234567890123456 | 1.23457E+15 | 1234567890123460 | 1.23456789012346E15 |
| 1/3 | 0.333333333 | 0.333333333333333 | 0.333333333333333 |
| 1E20 | 1E+20 | 1E+20 | 1E20 |
| 0.000001 | 0.000001 | 0.000001 | 1E-6 |
| 0.00000123456789 | 1.23457E-06 | 0.00000123456789 | 1.23456789E-6 |
마지막 열이 흘러간 이유를 설명합니다. FloatToStr는 Delphi의 general format을 열다섯 자리로 쓰고, 지수를 플러스 부호나 0 패딩 없이 적으며, 자기 기준 임계값에서 지수 표기법으로 갈아탑니다. 0.00001 아래, 또는 정수부가 열다섯 자리를 넘는 순간이죠. 소수 구분자도 호스트의 FormatSettings에서 가져옵니다. 로그 파일에는 훌륭한 함수입니다. 그러나 Excel의 어느 규칙도 재현하지 않으며, 표시와 formula 텍스트를 함께 서빙하라고 부탁당한 하나의 헬퍼는 그 두 규칙이 어긋나는 모든 행에서 틀립니다. 위 여섯 행 중 넷이죠
export나 lookup 키는 어느 텍스트를 써야 하는가
string이 어디서 비교될지 물어 규칙을 고르세요. 사람을 위한 텍스트 — PDF 보고서, HTML 표, 워크북 옆에서 누군가 열어 볼 CSV — 는 격자와 맞아야 하므로 셀의 표시 텍스트를 읽으세요. 데이터로 쓰이는 텍스트는 formula 규칙을 따라야 합니다. 이어 붙인 키, Excel formula가 만든 것과 비교되는 값, lookup string이죠. Excel이나 데이터베이스로 다시 불러들일 CSV도 데이터에 해당합니다. 그런 파일에 1.23457E+11을 적으면 계좌 번호의 다섯 자리를 영영 버리는 셈입니다. importer는 읽은 것을 파싱하며 원본을 복구할 수 없으니까요. 첫 예제는 세 string을 나란히 인쇄합니다. 샘플은 Double이지만 Int64나 Currency 값도 같은 식으로 표시됩니다:
uses
SysUtils, Variants, lxHandleX;
procedure CompareNumberTexts;
const
Samples: array[0..5] of Double =
(123456789012.0, 1234567890123456.0, 1 / 3, 1E20, 0.000001,
0.00000123456789);
var
Book: TXLSXWorkbook;
Sheet: TXLSXWorksheet;
I: Integer;
begin
Book := TXLSXWorkbook.Create;
try
Sheet := Book.Sheets.Add('Numbers');
for I := 0 to High(Samples) do
begin
Sheet.Cells[1, 1].Value := Samples[I]; // 기본은 General format입니다
Writeln(Format('%-22s %-22s %s', [
string(Sheet.Cells[1, 1].FormattedText), // 격자가 보여 주는 것
VarToStr(Sheet.Calculate('A1&""')), // formula가 보는 것
FloatToStr(Samples[I])])); // RTL 자신의 생각
end;
finally
Book.Free;
end;
end;
인쇄되는 각 줄은 표의 해당 행과 맞아야 합니다. 움직이는 것은 구분자뿐입니다. 독일어 호스트에서는 표시 열과 FloatToStr 열이 그 머신의 Excel 격자처럼 소수 쉼표로 바뀌지만, formula 열은 마침표를 지킵니다. 두 번째 예제는 이 선택을 Excel이 표시하는 식으로 보고서 텍스트를 쓰고, Excel formula가 만드는 식으로 키 열을 쓰는 exporter에 담습니다:
uses
SysUtils, Classes, Variants, lxHandleX, lxCalc;
// Excel에서 보이는 그대로의 보고서 텍스트, 그리고 locale 독립적인 키 열
procedure ExportInvoiceLines(Sheet: TXLSXWorksheet; FirstRow, LastRow: Integer;
Output: TStrings);
var
Row: Integer;
Shown, Key: string;
begin
for Row := FirstRow to LastRow do
begin
Shown := Sheet.Cells[Row, 3].FormattedText; // 금액, 표시되는 대로
Key := VarToStr(Sheet.EvaluateFormulaAt(Row, 6,
Format('A%d&"-"&C%d', [Row, Row])).Value); // 청구서 금액 키
Output.Add(Format('%s;%s', [Shown, Key]));
end;
end;
EvaluateFormulaAt는 저장하지 않은 채 주어진 셀에 앉아 있는 것처럼 formula를 평가하므로, 키는 워크북 안의 키 열에 Excel이 적용하는 같은 규칙에서 나옵니다. 금액이 currency나 천 단위 format을 지닌다면 FormattedText는 그 format을 적용하고, General 규칙은 format 없는 셀만 다룹니다. 반올림된 표시 값을 계산에 되먹이는 것은 Excel의 별개 스위치, precision as displayed이며, 이는 저장된 double 자체를 다시 쓰므로 텍스트만 필요한 export에는 끼어 들지 않게 두세요
열다섯 자리를 넘는 ID에는 무슨 일이 벌어지는가
텍스트가 되는 순간 꼬리를 잃습니다. double은 253, 약 9.007 × 1015까지의 모든 정수를 담으므로, 열여섯 자리 고객 번호 1234567890123456은 셀과 파일 안에서 온전히 살아남습니다. 유효숫자 열일곱이면 무손실 XLSX double 왕복에 충분하니까요. 텍스트는 이야기가 다릅니다. General 규칙은 1.23457E+15을 보여 주고, formula 규칙은 유효숫자 열다섯으로 반올림해 0으로 채우므로 =A1&""는 1234567890123460을 돌려줍니다. 다른 고객이죠. Excel은 셀에 직접 타이핑한 숫자도 유효숫자 열다섯만 지키므로, 값을 다시 타이핑하는 사용자는 1234567890123450에 착지합니다. 한 고객이 숫자 셋을 얻게 됩니다. 셀 안의 1234567890123456, formula 키의 1234567890123460, 재입력 후의 1234567890123450이죠
식별자는 처음부터 텍스트로 저장하세요. 계좌 번호, 카드 번호, 주문 ID는 숫자로 적힌 라벨입니다. 아무도 합산하지 않고, 앞의 0은 라벨의 일부죠. string으로 할당하면 같은 열여섯 글자로 격자와 모든 formula에 도착하고, 그에 대한 lookup은 결코 흘러가지 않습니다. Excel은 텍스트로 저장된 숫자라며 그런 셀에 작은 초록 삼각형을 달아 놓는데, 마지막 자리를 지키는 키 값이라면 감수할 만한 비용입니다:
// 식별자는 텍스트로 들어가고, 금액은 숫자로 남습니다
procedure WriteCustomerRow(Sheet: TXLSXWorksheet; Row: Integer;
const CustomerNo: string; Balance: Currency);
begin
Sheet.Cells[Row, 1].Value := WideString(CustomerNo); // '1234567890123456'이 온전히 남습니다
Sheet.Cells[Row, 2].Value := Balance; // General 규칙이 표시합니다
end;
exporter를 만지기 전에, 그것이 만든 워크북 하나를 Excel에서 열어 계좌 번호 열을 넓히고 옆에 =A1&""을 놓으세요. 하류 시스템이 왼쪽 string과 비교한다면 HotXLS Delphi Excel component에게 FormattedText를 부탁하고, 오른쪽 것과 비교한다면 텍스트를 EvaluateFormulaAt으로 만드세요