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()?

Level#

intermediate

Location#

include/petscstring.h

Examples#

src/ts/tutorials/ex8.c
src/ts/tutorials/ex18.c
src/ts/tutorials/extchem.c
src/ts/tutorials/ex11.c
src/dm/impls/forest/tutorials/ex1.c
src/ksp/ksp/tutorials/ex75.c
src/ksp/ksp/tutorials/ex72.c
src/ts/tutorials/extchemfield.c
src/ts/utils/dmplexlandau/tutorials/ex2.c
src/vec/is/sf/tutorials/ex1.c

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