PetscStrncpy#

Copies a string up to a certain length

Synopsis#

static inline PetscErrorCode PetscStrncpy(char s[], const char t[], size_t n)

Not Collective

Input Parameters#

  • t - pointer to string

  • n - the length to copy

Output Parameter#

  • s - the copied string

Notes#

NULL string returns a string starting with zero.

If the string that is being copied is of length n or larger, then the entire string is not copied and the final location of s is set to NULL. This is different then the behavior of strncpy() which leaves s non-terminated if there is not room for the entire string.

Developer Note#

Should this be PetscStrlcpy() to reflect its behavior which is like strlcpy() not strncpy()?

See Also#

PetscStrlcat(), PetscStrallocpy()

Level#

intermediate

Location#

include/petscstring.h

Examples#

src/dm/impls/forest/tutorials/ex1.c
src/ts/utils/dmplexlandau/tutorials/ex2.c
src/tao/constrained/tutorials/maros.c
src/ts/tutorials/extchemfield.c
src/ts/tutorials/ex11.c
src/vec/is/sf/tutorials/ex1.c
src/ts/tutorials/extchem.c
src/snes/tutorials/ex17.c
src/ts/tutorials/ex18.c
src/ts/tutorials/ex8.c


Index of all Sys routines
Table of Contents for all manual pages
Index of all manual pages