FcStrCopyFilename.3 revision a6844aab 
1.\\" auto-generated by docbook2man-spec $Revision: 1.1.1.2 $
2.TH "FcStrCopyFilename" "3" "18 November 2009" "" ""
3.SH NAME
4FcStrCopyFilename \- create a complete path from a filename
5.SH SYNOPSIS
6.nf
7\fB#include <fontconfig.h>
8.sp
9FcChar8 * FcStrCopyFilename(const FcChar8 *\fIs\fB);
10\fR.fi
11.SH "DESCRIPTION"
12.PP
13\fBFcStrCopyFilename\fR constructs an absolute pathname from
14\fIs\fR\&. It converts any leading '~' characters in
15to the value of the HOME environment variable, and any relative paths are
16converted to absolute paths using the current working directory. Sequences
17of '/' characters are converted to a single '/', and names containing the
18current directory '.' or parent directory '..' are correctly reconstructed.
19Returns NULL if '~' is the leading character and HOME is unset or disabled
20(see \fBFcConfigEnableHome\fR).
21.SH "VERSION"
22.PP
23Fontconfig version 2.8.0
24