3.2.35. strcpy

Copies a source string into a destination string.

Syntax

char *strcpy (dest, src)
char *dest;
char *src;

where:

dest

A character pointer, that specifies the starting address for the destination character string. Characters from the src string are copied to the dest string location.

src

A character pointer that specifies the starting address for the source character string. This string is copied to the dest character string address.

Description

This macro writes the src string directly to the dest string address beginning at the first byte pointed to by dest. It writes until encountering a NUL character '\0', which designates the end of the src string. It returns a pointer to the dest string.

This macro behaves like the strcpy function in the ANSI C string library.

Return value

char *

A pointer to the first byte in the string dest.

Rules

If the destination string is a debugger array, the macro checks the size of the array before copying. Otherwise this macro does not check to see whether the second string can fit in the first array. Failure to allocate enough space for the first array causes excess characters to overflow into adjacent memory locations. Consider using the strlen macro first to confirm that there is enough length in dest, for the src string.

Example

This example shows how to use strcpy on the command line:

add char buff[50]
ce strcpy(buff,"source string")
printf "%s\n",buff

See Also

Copyright © 2002-2009 ARM Limited. All rights reserved.ARM DUI 0175K
Non-Confidential