A função wcsncpy () em C ++ copia um número especificado de caracteres largos da origem ao destino.
A função wcsncpy () é definida no arquivo de cabeçalho.
protótipo wcsncpy ()
wchar_t * wcsncpy (wchar_t * dest, const wchar_t * src, tamanho_t contagem);
A função wcsncpy () aceita três argumentos: dest, src e count. Ele copia um máximo de contagem de caracteres largos da string larga apontada por src para a localização da memória apontada por dest.
Se a contagem for menor que o comprimento de src, os primeiros caracteres da contagem serão copiados para dest e não será terminada em nulo. Se a contagem for maior do que o comprimento de src, todos os caracteres largos de src são copiados para dest e caracteres largos nulos de terminação adicionais são adicionados até que um total de caracteres largos de contagem tenha sido escrito.
O comportamento é indefinido se as duas strings largas se sobrepõem.
Parâmetros wcsncpy ()
- dest: Ponteiro para uma ampla matriz de caracteres onde o conteúdo é copiado.
- src: Ponteiro para uma ampla matriz de caracteres de onde o conteúdo é copiado.
- contagem: número máximo de caracteres largos para copiar.
wcsncpy () Valor de retorno
- A função wcsncpy () retorna dest.
Exemplo: Como funciona a função wcsncpy ()?
#include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.utf8"); wchar_t src() = L"u0166u0113u010bu0127u0149u0151u013cu014cu0123u0194"; wchar_t dest() = L"Hello Hi"; wcout << L"Before copying, dest = " << dest << endl; wcsncpy(dest, src, 4); wcout << L"After copying, dest = " << dest << endl; return 0; )
Quando você executa o programa, a saída será:
Antes de copiar, dest = Hello Hi Depois de copiar, dest = Ŧēċħo Hi