## XSIUtils.WriteUTF16TextFile

### Introduced

v9.0 (2011)

### Description

Writes the given string in a new text file. If the string contains non-ASCII characters, the file will be a windows unicode ("UTF-16") text file compatible with Window's notepad and Softimage's Script Editor. Otherwise, it will be a normal text file. This function is useful to write out text files that could contain japanese characters. XSIUtils.ReadTextFile can be used to read the file back.

### C# Syntax

    XSIUtils.WriteUTF16TextFile( String in_Path, String in_text );

### Scripting Syntax

    oReturn = XSIUtils.WriteUTF16TextFile( in_path, in_string );

### Return Value

Returns True if the function succeeded

### Parameters

Parameter | Type | Description
--- | --- | ---
in_path | String | Path to the new text file.
in_string | String | New text of the file

### Examples

#### JScript Example

    var file_path = XSIUtils.BuildPath( XSIUtils.Environment("XSI_USERHOME"), "MyTextTestFile.txt" );

    var test_text = "Hello, world!";

    try

    {

    	XSIUtils.WriteUTF16TextFile( file_path, test_text );

    	Application.LogMessage( XSIUtils.ReadTextFile( file_path ) );

    }

    catch (e)

    {

    }

### See Also

XSIUtils.ReadTextFile XSIUtils.Environment