На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

lstrcpyn



The lstrcpyn function copies a specified number of characters from a source string into a buffer.

LPTSTR lstrcpyn(

LPTSTR lpString1, // address of target buffer
LPCTSTR lpString2, // address of source string
int iMaxLength // number of bytes or characters to copy
);


Parameters

lpString1

Points to a buffer into which the function copies characters. The buffer must be large enough to contain the number of bytes (ANSI version) or characters (Unicode version) specified by iMaxLength, including room for a terminating null character.

lpString2

Points to a null-terminated string from which the function copies characters.

iMaxLength

Specifies the number bytes (ANSI version) or characters (Unicode version) to be copied from the string pointed to by lpString2 into the buffer pointed to by lpString1, including a terminating null character.



Return Values

If the function succeeds, the return value is a pointer to the buffer.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

Note that the buffer pointed to by lpString1 must be large enough to include a terminating null character, and the string length value specified by iMaxLength includes room for a terminating null character. Thus, the following code


TCHAR chBuffer[512] ;

lstrcpyn(chBuffer, "abcdefghijklmnop", 4) ;


... copies the string "abc", followed by a terminating null character, to chBuffer.

See Also

lstrcat, lstrcmp, lstrcmpi, lstrcpy, lstrlen


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

lstrcpyn



Функция lstrcpyn копирует определенное количество символов из исходной строки в буфер.

LPTSTR lstrcpyn(

LPTSTR lpString1, // АДРЕС целевого буфера LPCTSTR lpString2, // адрес исходной строки количества int iMaxLength // байтов или символов, чтобы копироваться
);


Параметры

lpString1

Точки на буфер в которые функция копирует символы. Буфер должен быть большой достаточно, чтобы содержать количество байтов (версия ANSI) или символы (версия Уникода) определенного iMaxLength, включая место для завершающего недействительного символа.

lpString2

Точки на недействительный расторгнутую строку из которых функция копирует символы.

iMaxLength

Определяет байты числа (версии ANSI) или символы (версия Уникода), чтобы быть скопированн из строки указанной, чтобы lpString2 в буфер указанный, чтобы lpString1, включая завершающий недействительный символ.



Обратные Величины

Если функция добивается успеха, обратная величина является указателем в буфер.
Если функция терпит неудачу, обратная величина НЕДЕЙСТВИТЕЛЬНА. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Отметьте, что буфер указанный, чтобы lpString1 должен быть большой достаточно, чтобы включать завершающий недействительный символ, и величину длины строки определенные iMaxLength включает место для завершающего недействительного символа. Таким образом, следующее кода


TCHAR chBuffer[512];

lstrcpyn(chBuffer, "abcdefghijklmnop", 4);


... копирует строку "азбуки", сопровожденное завершающим недействительным символом, на chBuffer.

Смотри Также

lstrcat, lstrcmp, lstrcmpi, lstrcpy, lstrlen


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz