<doc>

<legacy_id>1263</legacy_id>

<name>ISOToMac</name>

<type>function</type>

<syntax>

<example>the ISOToMac of<i> ISOString</i></example>

<example>ISOToMac(<i>ISOString</i>)</example>

</syntax>

<synonyms>

</synonyms>

<summary><glossary tag="return">Returns</glossary> the equivalent of a Windows Latin 1 <keyword tag="string">string</keyword>, in the <glossary tag="Mac OS">Mac OS</glossary> <glossary tag="character set">character set</glossary>. </summary>

<examples>

<example>ISOToMac(&quot;Ab4+&quot;) </example>

<example>ISOToMac(&quot;) </example>

<example>charToNum(ISOToMac(numToChar(myASCIIVal))) </example>

</examples>

<history>

<introduced version="1.0">Added. </introduced>

<deprecated version=""></deprecated>

<removed version=""></removed>

</history>

<objects>

</objects>

<platforms>

<mac/>

<windows/>

<linux/>

<ios/>

<android/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

<mobile/>

</classes>

<security>

</security>

<classification>

<category>Text and Data Processing</category>

</classification>

<references>

<function tag="numToChar">numToChar Function</function>

<function tag="uniDecode">uniDecode Function</function>

</references>

<description>

<overview>Use the <b>ISOToMac</b> <control_st tag="function">function</control_st> to translate data that was created on a <glossary tag="Unix">Unix</glossary> or <glossary tag="Windows">Windows system</glossary> to the <glossary tag="Mac OS">Mac OS</glossary> <glossary tag="character set">character set</glossary>.</overview>

<parameters>

<parameter>The <i>ISOString</i> is any string.</parameter>

</parameters>

<value>The <b>ISOToMac</b> <control_st tag="function">function</control_st> <glossary tag="return">returns</glossary> the <i>ISOString</i>, with <keyword tag="characters">characters</keyword> whose <glossary tag="ASCII">ASCII value</glossary> is greater than 127 converted to their equivalent in the <glossary tag="Mac OS">Mac OS</glossary> <glossary tag="character set">character set</glossary>. <keyword tag="characters">Characters</keyword> whose <glossary tag="ASCII">ASCII value</glossary> is less than 128 are left unchanged.</value>

<comments><p>LiveCode automatically translates text in fields and scripts, as well as the names of custom properties, into the appropriate character set when you move a stack from one platform to another. It is therefore not necessary to translate them. However, the contents of custom properties, since they may contain binary data, are not translated automatically and must be translated if they contain characters whose ASCII value is 128 or greater.</p><p></p><p>Characters whose ASCII value is less than 128 are the same in the Mac OS character set and ISO 8859-1, so they are not changed by the <b>ISOToMac</b> <control_st tag="function">function</control_st>. These <keyword tag="characters">characters</keyword> include uppercase and lowercase letters, numbers, and most punctuation.</p></comments>

</description>

</doc>