FileNameJoin

✖
`FileNameJoin`

Updated in 14.1

✖

FileNameJoin[{"name₁","name₂",…}]

joins the name_i together into a file name suitable for your current operating system.

✖

FileNameJoin[{CloudObject[…],"name₂",…}]

joins the name_i to the path in the specified cloud object.

✖

FileNameJoin[{LocalObject[…],"name₂",…}]

joins the name_i to the path in the specified local object.

✖

FileNameJoin["name₁","name₂", …]

is equivalent to FileNameJoin[{"name₁","name₂",…}].

Details and Options

The "name_i" can be either individual names or file paths containing pathname separators.
FileNameJoin[{"","name₁",…}] gives an absolute file path beginning with a pathname separator.
FileNameJoin[…,OperatingSystem->"os"] yields a file name in the format for the specified operating system. Possible choices are "Windows", "MacOSX", and "Unix".
FileNameJoin just assembles a file name; it does not actually search for the file specified.
FileNameJoin["name"] canonicalizes the file name "name", making pathname separators appropriate for your operating system.
FileNameJoin[{URL["file:///path"],"name₂",…}] joins the name_i to the path in the specified file-based URL. »

Examples

open allclose all

Basic Examples (3)Summary of the most common use cases

Give a system-dependent file name:

In[1]:=1

✖

https://wolfram.com/xid/0g7fnxy2nua-jglt4a

Out[1]=1

Append the file name to a path:

In[1]:=1

✖

https://wolfram.com/xid/0g7fnxy2nua-jzbtxr

Out[1]=1

Construct a cloud object from a directory cloud object and a file name:

In[1]:=1

✖

https://wolfram.com/xid/0g7fnxy2nua-eqgldz

Out[1]=1

Scope (3)Survey of the scope of standard use cases

Append file name to a cloud object:

In[1]:=1

✖

https://wolfram.com/xid/0g7fnxy2nua-ombbjd

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0g7fnxy2nua-cwy7x

Out[2]=2

Append paths to a local object:

In[1]:=1

✖

https://wolfram.com/xid/0g7fnxy2nua-yebncj

Out[1]=1

Append paths to a file-based URL:

In[1]:=1

✖

https://wolfram.com/xid/0g7fnxy2nua-qya1f8

Out[1]=1

Applications (1)Sample problems that can be solved with this function

Get the path to a subdirectory of $LocalBase:

In[1]:=1

✖

https://wolfram.com/xid/0g7fnxy2nua-zbzdg7

Out[1]=1

Properties & Relations (2)Properties of the function, and connections to other functions

On Windows, the share name is treated as a single unit:

In[2]:=2

✖

https://wolfram.com/xid/0g7fnxy2nua-psueb7

Out[2]=2

FileNameJoin is the inverse of FileNameSplit:

In[1]:=1

✖

https://wolfram.com/xid/0g7fnxy2nua-n8dh2z

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0g7fnxy2nua-8gst3t

Out[2]=2

Possible Issues (1)Common pitfalls and unexpected behavior

Deploying to a cloud path generated with FileNameJoin will fail if the parent object is not a directory:

In[1]:=1

✖

https://wolfram.com/xid/0g7fnxy2nua-mk8qhr

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0g7fnxy2nua-b15p78

Out[2]=2

Top