<doc>
  <legacy_id>2184</legacy_id>
  <name>binfile</name>
  <type>keyword</type>
  <syntax>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Files, Folders, &amp; Resources</category>
  </classification>
  <references>
    <command tag="delete URL">delete URL Command</command>
    <keyword tag="file">file Keyword</keyword>
    <command tag="revCopyFile">revCopyFile Command</command>
    <property tag="fileType">fileType Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Used as a <keyword tag="URL">URL</keyword> type with the <command tag="get">get</command> and <command tag="put">put</command> <glossary tag="command">commands</glossary> to designate a <glossary tag="local file">local file</glossary>.</summary>
  <examples>
    <example>answer myConversionFunction(URL "binfile:input")</example>
    <example>put imageData into URL "binfile:/Main/project/test.gif"</example>
  </examples>
  <description>
    <p>Use the <b>binfile</b> <glossary tag="keyword">keyword</glossary> to work with <glossary tag="binary file">binary files</glossary>.</p><p/><p><b>Comments:</b></p><p>The <b>binfile</b> <glossary tag="URL scheme">scheme</glossary> indicates a <glossary tag="binary file">binary file</glossary> which is located on the user's system. The <keyword tag="file">file</keyword> is specified by either a <glossary tag="absolute file path">full path</glossary> starting with "/", or a <glossary tag="relative file path">relative path</glossary> starting from the <property tag="defaultFolder">defaultFolder</property>.</p><p/><p>A URL container can be used anywhere another container type is used.</p><p/><p>When you put data into a <b>binfile</b> <keyword tag="URL">URL</keyword> or get data from it, LiveCode does not translate <href tag="../glossary/enddashofdashline_marker.xml">end-of-line markers</href> (<glossary tag="ASCII">ASCII</glossary> 10 and <glossary tag="ASCII">ASCII</glossary> 13) between the current <glossary tag="platform">platform's</glossary> standard and LiveCode's internal standard of a linefeed. This ensures that <glossary tag="binary data">binary data</glossary>, which may contain such characters, is not accidentally corrupted.</p><p/><p>If you are working with text data (such as text in fields), use the <b>file</b> <glossary tag="URL scheme">URL scheme</glossary> instead.</p>
  </description>
</doc>