.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "FcStrCopyFilename" "3" "2022/03/31" "Fontconfig 2.14.0" ""

.SH NAME
FcStrCopyFilename \- create a complete path from a filename
.SH SYNOPSIS
.sp
\fB#include <fontconfig/fontconfig.h>
.sp
FcChar8 * FcStrCopyFilename (const FcChar8 *\fIs\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcStrCopyFilename\fR constructs an absolute pathname from
\fIs\fR\&. It converts any leading '~' characters in
to the value of the HOME environment variable, and any relative paths are
converted to absolute paths using the current working directory. Sequences
of '/' characters are converted to a single '/', and names containing the
current directory '.' or parent directory '..' are correctly reconstructed.
Returns NULL if '~' is the leading character and HOME is unset or disabled
(see \fBFcConfigEnableHome\fR).