lstrcpyn

원형

LPTSTR lstrcpyn(LPTSTR lpString1, LPCTSTR lpString2, int iMaxLength);

MFC 원형

 

인수

▶lpString1 : 복사할 버퍼

▶lpString2 : 원본 문자열

▶iMaxLength : 복사할 문자의 개수이며 널 종료 문자열의 개수도 포함된다. ANSI 버전에서는 바이트수로 인식되며 유니코드 버전에서는 문자 개수로 인식된다.

리턴

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

설명

원본 문자열 lpString2에서 iMaxLength-1개수분만큼의 문자열을 lpString1로 복사한다. lpString1은 최소한 iMaxLength길이를 가져야 하며 이 길이에는 널 종료 문자열도 포함된다. 다음 예제는 Src버퍼에 있는 문자열을 Dest의 4자분 길이만큼 복사한다.

예제 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);
		lstrcpyn(Dest,Src,4);
		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에는 6자 길이의 문자열이 있으며 이 문자열의 일부를 Dest로 복사하되 Dest버퍼에 4문자만큼만 복사하도록 하였다. 실행 결과 Dest에는 "Win"까지의 3문자와 널 종료 문자열이 복사된다.

결국 실제 복사되는 문자수는 iMaxLength-1문자분만큼이다. 만약 5자를 복사하려면 iMaxLength는 6의 값을 가져야 하며 Dest는 6이상의 길이를 가져야 한다. Dest 버퍼가 복사될 길이보다 짧을 경우 주변 메모리가 파괴될 수 있으며 두 버퍼 영역이 겹쳐 있을 경우 이 함수의 동작은 예측할 수 없으므로 피해야 한다. 이 함수는 유니코드를 지원하며 윈도우즈가 제공하는 API 함수이므로 실행 파일의 크기를 증가시키지 않는다.

만약 원본 문자열의 중간에서부터 일정 개수만큼의 문자열을 복사하고자 할 경우 +연산자로 원본 문자열의 중간 부분을 지정하면 된다. 예를 들어 "WinApi"문자열의 세번째 문자부터 세문자를 복사하려면 lstrcpyn(Dest, Src+2,4);를 호출해 주면 된다. 이 호출결과 Dest에는 "nAp"가 복사된다.

참고함수

lstrcpy : 원본 문자열 전부를 복사한다.

플랫폼

95이상

참조

 


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