델파이 2009 부터 기본 문자열 캐릭터셋으로 UnicodeString이 사용됩니다.

유니코드 지원에 따른 델파이 변경사항을 알아봅니다.

 

* 아래 제목을 클릭해 원하는 내용으로 바로 이동할 수 있습니다.

 

유니코드 지원에 따른 델파이 변경사항

  - 문자열 데이터 타입 선언의 변경

  - 문자열 길이와 데이터 크기의 변경

유니코드 검토 대상 분석 도구 안내

 

 데이터 타입

 유니코드 지원하지 않는 버전

 (델파이 2007 이전)

 유니코드 지원하는 버전

 (델파이 2009 이후)

 string

 AnsiString

 UnicodeString

 Char

 AnsiChar

 WideChar

 PChar

 PAnsiChar

 PWideChar

 PAnsiChar

 PAnsiChar

 PAnsiChar

 PWideString

 PWideChar

 PWideChar

 AnsiString

 AnsiString

 AnsiString

 WideString

 WideString

 WideString

 

string으로 선언된 데이터 타입들은 이제 UnicodeString으로 사용됩니다. 또, Char 타입은 WideChar으로, PChar 타입은 PWideChar으로 사용됩니다. 명시적인 PAnsiChar, AnsiString, PWideChar, WideString은 유지됩니다.

 

이 변경에 의해 검토할 사항은, 코드상에서 string과 AnsiString 또는 PAnsiChar를 혼용해서 사용하는 코드를 검토하고 수정해야 합니다. string과 AnsiString 또는 PAnsiString을 혼용해 사용하는 경우 데이터 크기의 차이에 따라 데이터 손실이 발생할 수 있습니다. 자세한 내용은 “문자열의 메모리 크기 변경” 항목을 참고하시기 바랍니다.

 

대표적으로 검토해야 할 항목은 다음과 같습니다.

 

1, UnicodeString과 AnsiString을 혼용해서 사용하는지 검토

2, 데이터 형변환 시 데이터 타입 검토

3, 윈도우 API 호출하는 코드 검토

4, 외부 라이브러리(DLL 등) 인터페이스 검토

5, 데이터베이스 캐릭터셋 검토

 

UnicodeString과 AnsiString을 혼용해서 사용하는 경우

var UStr, UStr2: string;

  AStr: AnsiString;

begin

  UStr := ‘ケーシ’;

AStr := UStr;      // 출력 : ケ?シ

  UStr2 := AStr;     // 출력 : ケ?シ, 데이터 손실 발생

end;

string 변수를 AnsiString 변수에 할당하는 경우 데이터 손실이 발생할 수 있습니다.

 

데이터 형변환(Type Casting) 시 데이터 타입 검토 

var path: string;

begin

  path := 'C:\Program Files\Internet Explorer\iexplore.exe';

  WinExec(PAnsiChar(AnsiString(path)), SW_SHOW);

end;

PChar(PWideChar)로 형변환 시 string(WideString)을 전달, PAnsiChar로 형변환 시 AnsiString으로 전달해야 합니다. 만약, PAnsiChar(string)와 같이 형변환 시 string 변수의 첫글자만 전달될 수 있습니다.

 

윈도우 API 호출하는 코드 검토

문자열을 다루는 대부분의 윈도우 API는 AnsiString과 WideString용 API를 제공합니다. 델파이는 AnsiString과 WideString외에도 기본 문자열 캐릭터셋(string)을 제공합니다. 즉, string이 AnsiString에서 WideString으로 변경됨에 따라 윈도우 API도 WideString용 API를 사용하게 됩니다.

코드상에서 문자열 포인터를 만들어 전달 시 AnsiString 기반의 캐릭터를 이용할 경우 AnsiString용 API를 사용하도록 코드를 변경해야 합니다. 

 

다음과 같이 데이터 타입에 맞도록 문자열 포인터를 만들어 전달해야 합니다.

var AnsiStr: AnsiString;

Str: string;

begin

  OutputDebugString(PChar(Str));

  OutputDebugStringA(PAnsiChar(AnsiStr));

  OutputDebugStringA(PAnsiChar(AnsiString(Str))); // 강제로 AnsiString API를 이용해야 할 경우

end;

 

외부 라이브러리(DLL 등) 인터페이스 검토

외부 라이브러리(DLL)와 문자열을 주고 받을 경우 다음 경우에 따라 조치하기 바랍니다.

 

* 델파이로 직접 DLL을 제작한 경우

  - DLL의 export 메소드의 문자열 포인터 데이터 타입을 PChar 또는 PWideChar로 변경 후 다시 빌드해 사용합니다.

* DLL을 직접 제작하지 않은 경우

  -DLL에서 유니코드 지원 메소드를 제공하는지 확인합니다.

  - 만약, 제공하지 않는다면, DLL 인터페이스를 참고해 PAnsiChar 로 DLL Export 메소드의 데이터타입을 변경하고, PAnsiChar(AnsiString(string))와 같이 형변환해 데이터를 전달합니다.
    (이 경우 DLL로 전달하거나, 전달받는 문자열은 유니코드를 제공하지 않습니다.)

 

데이터베이스 캐릭터셋 검토

데이터베이스 연결 시 한글이 정상표시되는지 확인해야합니다.

만약, 한글이 정상표시되지 않는다면 연결설정의 캐릭터셋을 Unicode 또는 UTF8로 설정하기 바랍니다.

만약, FireDAC을 이용한다면, MapRules을 통해 AnsiString을 WideString으로 적용하는 규칙을 추가할 수 있습니다.

 

자세한 내용은 http://tech.devgear.co.kr/429974 링크를 참고하세요.

 

 

문자열 길이의 변경

UnicodeString 기반의 문자열의 길이는 문자의 종류와 관계없이 모두 1로 계산됩니다. AnsiString 기반의 문자열은 한글등의 멀티-캐릭터셋 문자의 경우 2로, 영문자/숫자/특수문자의 길이는 1로 계산됩니다.

 

 

 string(UnicodeString)

 AnsiString

 Length('한글1'); 

 3

 5

 

문자열 데이터 크기의 변경

UnicodeString 기반의 문자열은 모든 문자가 2Byte의 메모리를 사용합니다. 

widechar_ansichar.png

이제 더 이상 문자열의 길이와 문자열의 데이터 크기가 일치하지 않습니다. UnicodeString 문자열의 데이터 크기를 계산하려면 문자열의 길이 * SizeOf(Char)로 계산해야 합니다.

이 변경으로 검토할 대표적인 항목은 다음과 같습니다.

  1. 문자열 길이와 데이터크기가 같다고 간주한 코드
  2. Char 크기를 1로 간주해 길이를 직접 입력한 코드

 

var

  Count: Integer;

  Buf1, Buf2: Array[0..13] of Char;

begin

  Buf1 := ‘가나다라마바사아자차카타파하’;

 

  // 잘못됨: 길이를 직접 입력한 코드, 길이로 데이터 크기를 계산한 코드

Move(Buf1, Buf2, 14);

Move(Buf1, Buf2, Length(Buf1));

  // Buf2 = 가나다라마바사

 

  // 올바름: 문자열 길이와 문자 크기를 곱해 데이터 복사

  Move(Buf1, Buf2, Length(Buf1) * SizeOf(Char));

  // Buf2 = 가나다라마바사아자차카타파하

end;

 

검토해야하는 대표적인 키워드

 Length

 FillChar

 Read

 ReadBuffer

 Write

 WriteBuffer

 Copy

 Seek

 AllocMem

 GetMem

 StrAlloc

 AnsiStrAlloc

 Delete  Insert  Pos  LeftStr  RightStr  MidStr
 Move          

 

잠재적으로 수정될 필요가 있을 수 있는 코드

 

  •  “of Char” 텍스트와 “of AnsiChar” 텍스트를 검색하여 버퍼가 유니코드에 맞게 사용되었는지 확인합니다. 
  •  “string[” 텍스트를 검색하여 스트링 인덱스의 문자가 대입되는 변수가 Char(즉 WideChar)가 아닌 AnsiChar 타입 변수로 지정되도록 수정합니다. 
  •  “AnsiString”, “AnsiChar”, “PAnsiChar”를 명시적으로 지정한 부분을 찾아 그럴 필요가 있고 제대로 되어 있는지 확인합니다. 
  •  “ShortString”을 명시적으로 지정한 부분을 찾아 그럴 필요가 있고 제대로 되어 있는지 확인합니다. 
  •  “Length(” 텍스트를 검색하여 Length가 SizeOf와 동일한 의미로 사용되지는 않았는지 확인합니다. 
  •  “Copy(” , “Seek(” , “Pointer(” , “AllocMem(”, “GetMem(” 텍스트를 검색하여 스트링 혹은 문자 배열에 대해 제대로 동작하는지 확인합니다.

 

소스코드를 대상으로 유니코드 적용 시 검토 대상을 분석 후 안내해 주는 도구입니다. 아래 링크에서 다운로드 할 수 있습니다.

unicode_statistics.png

 

 

위에서 설명한 각 키워드별 조치방법을 아래의 문서에서 찾아보시기 바랍니다.

 - [바로가기] 데브기어-마이그레이션-이슈공유 문서 보기

 

위 문서에도 원하는 답이 없다면 개발자 Q&A에서 검색 후, 결과가 없다면 질문을 등록해 다른 개발자들의 도움을 받아보시기 바랍니다.

 - [바로가기] 데브기어 개발자 Q&A

 

마이그레이션 참고 리소스


 

번호 제목 글쓴이 날짜 조회 수
공지 [DelphiCon 요약] 코드사이트 로깅 실전 활용 기법 (Real-world CodeSite Logging Techniques) 관리자 2021.01.19 22444
공지 [UX Summit 요약] 오른쪽 클릭은 옳다 (Right Click is Right) 관리자 2020.11.16 20967
공지 [10.4 시드니] What's NEW! 신기능 자세히 보기 관리자 2020.05.27 23039
공지 RAD스튜디오(델파이,C++빌더) - 고객 사례 목록 관리자 2018.10.23 28818
공지 [데브기어 컨설팅] 모바일 앱 & 업그레이드 마이그레이션 [1] 관리자 2017.02.06 30017
공지 [전체 목록] 이 달의 기술자료 & 기술레터 관리자 2017.02.06 25366
공지 RAD스튜디오(델파이, C++빌더) - 시작하기 [1] 관리자 2015.06.30 46310
공지 RAD스튜디오(델파이,C++빌더) - 모바일 앱 개발 사례 (2020년 11월 업데이트 됨) 험프리 2014.01.16 182139
403 [XE7] 병렬(페러럴) 컴퓨팅 라이브러리 소개 Humphery 2014.09.22 3448
402 [XE7] 다양한 형태로 표시되는 적응형 컴포넌트 TMultiView 소개 Humphery 2014.09.18 2122
401 [XE7] 멀티 디바이스 디자이너 소개 [1] Humphery 2014.09.18 2552
400 [온라인 세미나 발표자료] RAD Studio XE7! 관리자 2014.09.17 1669
399 [기술문서] 델파이와 유니코드 관리자 2014.09.16 1965
398 [기술문서] 델파이XE2와 파이어몽키 관리자 2014.09.16 1681
397 [기술문서] Delphi 코딩 스타일과 아키텍처(Delphi 2009의 언어 기능 리뷰) 관리자 2014.09.16 1554
396 "Could not load SSL library." 오류 대응(XE7: BaaS, RESTClient, DataSnap) [1] Humphery 2014.09.12 16087
395 이 달의 기술자료 - 2014년 10월 file 험프리 2014.09.12 4877
394 안드로이드에서 NFC 연동 방법 Humphery 2014.09.12 3196
393 [Android] 폰번호 가져오기 [1] 타락천사 2014.09.05 38628
392 [세미나 자료] RAD Studio XE7 출시 세미나(2014.9.2/3) file 관리자 2014.09.05 1318
391 RAD Studio 최신 데모 소스코드 다운로드 Humphery 2014.09.04 4275
390 [기술문서] 실전 DataSnap! [2] 관리자 2014.09.02 2335
389 [기술문서] RAD Studio 라이브바인딩(LiveBindings) 이해하기 관리자 2014.09.02 2452
388 델파이 튜토리얼 자습서 이용 안내 관리자 2014.09.01 71985
387 [Step UP! 마이그레이션] RAD 업그레이드 마이그레이션 기술 브리핑 자료(2014.8.21) 관리자 2014.08.22 2015
» [마이그레이션] 유니코드 적용시 검토할 사항들 file 험프리 2014.08.21 7248
385 [업데이트][HotFix] VCL BMP Buffer Overflow hotfix(취약점 보안패치) Humphery 2014.08.20 1544
384 코드 아카데미: 세션4. 푸쉬알림 (2014.8.19) 관리자 2014.08.20 1355