binfile

Used as a URL type with the get and put commands to designate a local file.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

binfile

# Examples

answer myConversionFunction(URL "binfile:input")

put imageData into URL "binfile:/Main/project/test.gif"

# Description

Use the binfile keyword to work with binary files.

The binfile URL scheme indicates a binary file which is located on the user's system. The file is specified by either a absolute file path starting with "/", or a relative file path starting from the defaultFolder.

A URL container can be used anywhere another container type is used.

When you put data into a binfile URL or get data from it, LiveCode does not translate end-of-line markers (ASCII 10 and ASCII 13) between the current platform standard and LiveCode's internal standard of a linefeed. This ensures that binary file, which may contain such characters, is not accidentally corrupted.

If you are working with text data (such as text in fields), use the file URL scheme instead.

# Tags

file system,

# See

- **keyword:** URL, file - **property:** fileType, defaultFolder - **command:** revCopyFile, delete URL, put, get - **glossary:** platform, binary file, ASCII, local file, absolute file path, URL scheme, keyword, relative file path, end-of-line marker, command