---
name: "ustrzcpy"
section: "3alleg4"
platform: "linux"
package: "allegro4-doc"
version: "2:4.4.3.1-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ustrzcpy/3alleg4"
---

# ustrzcpy(3alleg4)

Copies a string into another one, specifying size. Allegro game programming library.

## NAME

ustrzcpy - Copies a string into another one, specifying size. Allegro game programming library.

## SYNOPSIS

**#include \<allegro.h\>**

**char \*ustrzcpy(char \*dest, int size, const char \*src);**

## DESCRIPTION

This function copies \`src' (including the terminating null character) into \`dest', whose length in bytes is specified by \`size' and which is guaranteed to be null-terminated even if \`src' is bigger than \`size'.

Note that, even for empty strings, your destination string must have at least enough bytes to store the terminating null character of the string, and your parameter \`size' must reflect this. Otherwise, the debug version of Allegro will abort at an assertion, and the release version of Allegro will overrun the destination buffer.

## RETURN VALUE

Returns the value of \`dest'.

## SEE ALSO

**uconvert**(3alleg4), **ustrcpy**(3alleg4), **ustrzncpy**(3alleg4), **ex3buf**(3alleg4), **exgui**(3alleg4)