lstrcpy

원형

LPTSTR lstrcpy(LPTSTR lpString1, LPCTSTR lpString2);

MFC 원형

const CString& operator =( const CString& stringSrc ); const CString& operator =( LPCSTR lpsz );

인수

▶lpString1 : 복사할 버퍼

▶lpString2 : 원본 문자열

리턴

복사에 성공하면 복사한 버퍼의 포인트(lpString1)가 리턴되며 실패했을 경우 NULL을 리턴한다.

설명

lpString2 문자열을 lpString1 버퍼에 복사한다. 이때 문자열을 복사받을 lpString1은 원본 문자열을 충분히 저장할 수 있는 충분한 길이를 가지고 있어야 한다. 만약 그렇지 않으면 이 버퍼의 뒷부분에 있는 다른 변수의 값이 파괴되며 프로그램이 다운될 수도 있다. 다음 예제는 Src문자열을 Dest버퍼로 복사한 후 이 문자열을 화면으로 출력한다.

예제 1 

LRESULT CALLBACK WndProc(HWND hWnd,UINT iMessage,WPARAM wParam,LPARAM lParam)
{
	HDC hdc;
	PAINTSTRUCT ps;
	TCHAR Src[]=TEXT("WinApi");
	TCHAR Dest[100];

	switch(iMessage) {
	case WM_PAINT:
		hdc=BeginPaint(hWnd, &ps);
		lstrcpy(Dest,Src);
		TextOut(hdc,10,10,Dest,lstrlen(Dest));
		EndPaint(hWnd, &ps);
		return 0;
	case WM_DESTROY:
		PostQuitMessage(0);
		return 0;
	}
	return(DefWindowProc(hWnd,iMessage,wParam,lParam));
}

Src문자열과 동일한 문자열 Dest를 만든 후 Dest를 화면에 출력하였다. 실행중의 모습은 다음과 같으며 단순히 문자열 복사를 확인하기만 한다.

이 함수는 널 종료 문자를 포함하여 Src의 모든 문자를 Dest 버퍼로 일대일 복사한다. Dest는 Src의 모든 문자를 복사받을 수 있는 충분한 길이를 가져야 하는데 여기에는 널 종료 문자의 길이도 포함된다. 또한 Src와 Dest의 영역이 겹쳐 있을 경우 이 함수의 동작은 예측할 수 없으므로 피해야 한다.

문자열 버퍼에 문자열을 복사하는 가장 일반적인 방법은 이 함수를 사용하는 것이다. 다음 코드는 정상적으로 동작하지 않는다.

TCHAR str[128];
str="string";

왜냐하면 str은 문자형의 배열이고 배열명 자체는 배열의 선두 주소를 가리키는 포인터 상수이기 때문에 상수 자체를 다른 값으로 변경할 수 없다. str버퍼에 문자열을 복사하려면 이 함수로 lstrcpy(str,"string"); 와 같이 호출해 주어야 한다.

strcpy같은 표준 C 런타임 함수와 다른 점은 유니코드를 지원한다는 점이다. UNICODE 매크로 상수의 정의 여부에 따라 이 함수는 유니코드 문자열을 복사할 수도 있으므로 strcpy보다는 호환성에 유리하다. 또한 윈도우즈가 운영체제 차원에서 제공하는 API 함수이기 때문에 실행 파일의 크기를 증가시키지 않는다.

참고함수

lstrlen : 문자열의 길이를 구한다.

lstrcpyn : 일정 개수의 문자열만 복사한다.

플랫폼

95이상

참조

 


written by http://www.winapi.co.kr