LocalObject
✖
LocalObject
represents a new anonymous local object.
LocalObject["file:///…"]
represents a local object with a given file path.
LocalObject["relpath"]
represents a local object with the given relative path.
LocalObject["relpath","lbase"]
represents a local object relative to the base lbase.
Details

- Relative paths are resolved with respect to $LocalBase.
- LocalObject[File["path"]] and LocalObject[relpath,File["path"]] are also supported.
- DeleteObject[LocalObject[…]] removes a local object.
- LocalObject[…]["Properties"] gives the list of all supported properties of the given local object.
- LocalObject[…]["property"] gives the value of the specified property for the given local object.
- Properties of local objects include:
-
"URL" the absolute file: URL of the local object "Type" the type of information stored in the local object "ObjectFile" the absolute path of the metadata file "DataFile" the absolute path of the data file - LocalObject[…][All] gives an association of propertyvalue pairs for all properties of the given local object.
Examples
open allclose allBasic Examples (3)Summary of the most common use cases

https://wolfram.com/xid/0tz3j77m-vjuqr6

A named local object in the user's local base directory:

https://wolfram.com/xid/0tz3j77m-pbetwd

A named local object in a subdirectory of the user's local base directory:

https://wolfram.com/xid/0tz3j77m-kibcqc


https://wolfram.com/xid/0tz3j77m-xcve0s


https://wolfram.com/xid/0tz3j77m-6ar307
Scope (8)Survey of the scope of standard use cases
Local objects can be used with Put and Get to store expressions persistently:

https://wolfram.com/xid/0tz3j77m-3g94j


https://wolfram.com/xid/0tz3j77m-djmveh

Local objects can be used with Export and Import to store data persistently:

https://wolfram.com/xid/0tz3j77m-f30ymd


https://wolfram.com/xid/0tz3j77m-hkuvm2

Local objects can be used with CopyFile to store files persistently:

https://wolfram.com/xid/0tz3j77m-mt3118

https://wolfram.com/xid/0tz3j77m-070l2w

Import the file stored in the local object:

https://wolfram.com/xid/0tz3j77m-8zky75

Local objects can be used with Save to save definitions persistently:

https://wolfram.com/xid/0tz3j77m-cli7zk

https://wolfram.com/xid/0tz3j77m-gzks5w

Definitions saved can be read into the Wolfram Language using Get:

https://wolfram.com/xid/0tz3j77m-geew1n

https://wolfram.com/xid/0tz3j77m-s8d09r

https://wolfram.com/xid/0tz3j77m-r22o3h

Local objects can be used with DumpSave to save definitions persistently:

https://wolfram.com/xid/0tz3j77m-gwa6kc

https://wolfram.com/xid/0tz3j77m-ntjijs


https://wolfram.com/xid/0tz3j77m-ouoi
Restore the definitions for f from the local object:

https://wolfram.com/xid/0tz3j77m-3w2tke

https://wolfram.com/xid/0tz3j77m-tjz0j4
Local objects can be deleted with DeleteObject:

https://wolfram.com/xid/0tz3j77m-w16urp
Local objects can be listed with LocalObjects:

https://wolfram.com/xid/0tz3j77m-mn8njn


https://wolfram.com/xid/0tz3j77m-jdfgmt

Display information about the local object:

https://wolfram.com/xid/0tz3j77m-ldtqg2

Give the list of all known properties:

https://wolfram.com/xid/0tz3j77m-onj5uc

Give the value of a specific property:

https://wolfram.com/xid/0tz3j77m-nn6yxg

Give an association of all property-value pairs:

https://wolfram.com/xid/0tz3j77m-mzkdq1

Generalizations & Extensions (3)Generalized and extended use cases
Local objects can be created in any file:

https://wolfram.com/xid/0tz3j77m-w3rm2s

File paths can also be specified with File:

https://wolfram.com/xid/0tz3j77m-pp9cgw


https://wolfram.com/xid/0tz3j77m-lnj0rb

The base for resolving relative paths can be given as the second argument:

https://wolfram.com/xid/0tz3j77m-qpw6wt

https://wolfram.com/xid/0tz3j77m-l6ewp9

The base can be taken from another local object:

https://wolfram.com/xid/0tz3j77m-f1xgvh


https://wolfram.com/xid/0tz3j77m-jjlwui

Applications (1)Sample problems that can be solved with this function
Properties & Relations (9)Properties of the function, and connections to other functions
Relative paths are resolved with respect to $LocalBase:

https://wolfram.com/xid/0tz3j77m-j8anby


https://wolfram.com/xid/0tz3j77m-oungod

Local symbols are local objects stored in the directory $LocalSymbolBase:

https://wolfram.com/xid/0tz3j77m-pi2uw7

A file scheme URL can be converted to a path by ExpandFileName:

https://wolfram.com/xid/0tz3j77m-b3n6eo


https://wolfram.com/xid/0tz3j77m-brdjau


https://wolfram.com/xid/0tz3j77m-5mvk8j

A local object can be given directly in ExpandFileName:

https://wolfram.com/xid/0tz3j77m-z4lw7o

File scheme URLs and local objects can be used in FileNameSplit:

https://wolfram.com/xid/0tz3j77m-tmptgz


https://wolfram.com/xid/0tz3j77m-3ujbrf

CloudObject provides for persistent storage in the cloud:

https://wolfram.com/xid/0tz3j77m-fzrn2p

Find all local objects used as caches:

https://wolfram.com/xid/0tz3j77m-z9u10s

RenameFile works on local objects:

https://wolfram.com/xid/0tz3j77m-6bj6fn


https://wolfram.com/xid/0tz3j77m-f6rqp3


https://wolfram.com/xid/0tz3j77m-fzaykl

FileNameJoin works with local objects:

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

Possible Issues (2)Common pitfalls and unexpected behavior
Applying LocalObject by itself does not create the referenced file:

https://wolfram.com/xid/0tz3j77m-dndxc8


https://wolfram.com/xid/0tz3j77m-8wm3j9


https://wolfram.com/xid/0tz3j77m-y3s8p5

Only by writing content is it actually created:

https://wolfram.com/xid/0tz3j77m-85lc2m


https://wolfram.com/xid/0tz3j77m-kjt431

Most properties are undefined for nonexistant objects:

https://wolfram.com/xid/0tz3j77m-fru8ng

Wolfram Research (2015), LocalObject, Wolfram Language function, https://reference.wolfram.com/language/ref/LocalObject.html.
Text
Wolfram Research (2015), LocalObject, Wolfram Language function, https://reference.wolfram.com/language/ref/LocalObject.html.
Wolfram Research (2015), LocalObject, Wolfram Language function, https://reference.wolfram.com/language/ref/LocalObject.html.
CMS
Wolfram Language. 2015. "LocalObject." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/LocalObject.html.
Wolfram Language. 2015. "LocalObject." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/LocalObject.html.
APA
Wolfram Language. (2015). LocalObject. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/LocalObject.html
Wolfram Language. (2015). LocalObject. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/LocalObject.html
BibTeX
@misc{reference.wolfram_2025_localobject, author="Wolfram Research", title="{LocalObject}", year="2015", howpublished="\url{https://reference.wolfram.com/language/ref/LocalObject.html}", note=[Accessed: 12-April-2025
]}
BibLaTeX
@online{reference.wolfram_2025_localobject, organization={Wolfram Research}, title={LocalObject}, year={2015}, url={https://reference.wolfram.com/language/ref/LocalObject.html}, note=[Accessed: 12-April-2025
]}