d22155a179812cfb2a3b995c2e1ecda587d0061a
[platform/upstream/fontconfig.git] / doc / FcStrCopyFilename.3
1 .\" auto-generated by docbook2man-spec from docbook-utils package
2 .TH "FcStrCopyFilename" "3" "30 8月 2018" "Fontconfig 2.13.1" ""
3 .SH NAME
4 FcStrCopyFilename \- create a complete path from a filename
5 .SH SYNOPSIS
6 .nf
7 \fB#include <fontconfig/fontconfig.h>
8 .sp
9 FcChar8 * FcStrCopyFilename (const FcChar8 *\fIs\fB);
10 .fi\fR
11 .SH "DESCRIPTION"
12 .PP
13 \fBFcStrCopyFilename\fR constructs an absolute pathname from
14 \fIs\fR\&. It converts any leading '~' characters in
15 to the value of the HOME environment variable, and any relative paths are
16 converted to absolute paths using the current working directory. Sequences
17 of '/' characters are converted to a single '/', and names containing the
18 current directory '.' or parent directory '..' are correctly reconstructed.
19 Returns NULL if '~' is the leading character and HOME is unset or disabled
20 (see \fBFcConfigEnableHome\fR).