새로운 글
새로운 덧글

델파이 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(” 텍스트를 검색하여 스트링 혹은 문자 배열에 대해 제대로 동작하는지 확인합니다.

 

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

 

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

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

 

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

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

 

마이그레이션 참고 리소스


 

번호 제목 글쓴이 날짜 조회 수
공지 [데브기어 컨설팅] 모바일 앱 & 업그레이드 마이그레이션 관리자 2017.02.06 132
공지 이 달의 기술자료 & 기술레터 관리자 2017.02.06 154
공지 데브기어 강의 - 2017년 5월~2017년 7월 관리자 2015.01.22 5240
공지 RAD Studio(Delphi, C++Builder) 시작하기 관리자 2015.06.30 7667
공지 RAD 스튜디오로 개발된 모바일 앱 사례(17년 5월 2일 업데이트) 험프리 2014.01.16 145002
748 [발표자료] REST API 웹서비스 연동 관리자 2017.05.29 29
747 [REST API][실습] REST API 클라이언트 개발하기(REST Client 이용) 험프리 2017.05.23 54
746 [REST API][실습] REST API 서버 개발하기(엔드포인트 구현, RAD 서버 이용) 험프리 2017.05.23 48
745 [REST API] REST API 이해하기 험프리 2017.05.23 61
744 델파이 코드 분석 도구 험프리 2017.05.16 97
743 애플 개발자 프로그램 구독하지 않고 XCode8을 설정해 iOS앱을 배포하는 방법 험프리 2017.05.15 85
742 안드로이드에서 커스텀 폰트 사용하기 - 델파이 10.2 도쿄 험프리 2017.05.15 50
741 [고객 사례- 조명, 델파이] 나이아가라 폭포 야간 조명 [1] 관리자 2017.05.10 211
740 [업데이트][핫픽스][10,2 도쿄] 툴체인 이슈 핫픽스 험프리 2017.05.10 102
739 [RAD서버] EMS 패키지 프로젝트 시작하기 험프리 2017.04.28 65
738 [RAD서버] EMS 서버 운영환경에 설치하기(독립형 실행파일) 험프리 2017.04.28 81
737 이 달의 기술자료 - 2017년 05월 file 험프리 2017.04.26 145
736 리눅스 서버용 GUI 응용프로그램 만들기(10.2 도쿄 & FMXLINUX 이용) 관리자 2017.04.25 202
735 [환경설정] 아마존 EC2 이용해 리눅스 서버 환경 구축하기 험프리 2017.04.20 149
734 [환경설정] 아마존 EC2 이용해 윈도우 서버 환경 구축하기 [1] 험프리 2017.04.13 171
733 [발표자료] What's NEW! RAD Studio 10.2 도쿄 험프리 2017.04.13 131
732 [고객 사례- 3D, 이미지스캐너, 델파이] mimix 3D 프로필 스캐너 관리자 2017.04.13 144
731 [RAD 서버] 비콘펜스 소개 및 데모(실내외 길찾기, 지역진입 감지하기) [1] 험프리 2017.04.13 100
730 [발표자료] 소개합니다! RAD Studio 10.2 도쿄 관리자 2017.04.06 178
729 이 달의 기술자료 - 2017년 04월 file 험프리 2017.03.30 185


광고 모듈이 설치되어 있지 않아 실행을 중단합니다..