[#BloombergLP-bdls-PathUtil-appendRaw-0d8]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdls.adoc[bdls]::xref:BloombergLP/bdls/PathUtil.adoc[PathUtil]::appendRaw
:relfileprefix: ../../../
:mrdocs:

Append a filename to the end of a path&period;

== Synopsis

Declared in `&lt;bdls&lowbar;pathutil&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
appendRaw(
    xref:bsl/string.adoc[bsl::string]* path,
    char const* filename,
    int length = &hyphen;1,
    int rootEnd = &hyphen;1);
----

== Description

Append the specified `filename` up to the optionally specified `length` to the end of the specified `path`&period; If `length` is negative, append the entire string&period; If the optionally specified `rootEnd` offset is non&hyphen;negative, it is taken as the position in `path` of the character following the root&period; The behavior is undefined if `filename` represents an absolute path or if either `filename` or `path` ends with the filesystem separator character&period; The behavior is also undefined if `filename` points to any part of `path` (i&period;e&period;, `filename` may not be an alias for `path`)&period; See &lsqb;&rsqb;and Performance)&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *path*
| path to which `filename` is appended
| *filename*
| null&hyphen;terminated filename to append
| *length*
| maximum number of characters of `filename` to append&semi; if negative, append the entire string
| *rootEnd*
| if non&hyphen;negative, position in `path` of the character following the root
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#
