Plugin.LoadIconvLibrary
-----------------------

Loads the iconv library.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Plugin](component_Plugin.md) | [10.4](newinversion104.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "Plugin.LoadIconvLibrary"; Path ) 

**MBS**( **"Plugin.LoadIconvLibrary";** /\* Loads the iconv library. \*/  
**$Path**) /\* The path to the library.e.g. "/usr/lib/libiconv.dylib" \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Path | The path to the library. | "/usr/lib/libiconv.dylib" |

### Result

Returns OK or error.

### Description

Loads the iconv library.  
Some plugin parts like [Archive](component_Archive.md) functions can make use of libiconv for text encoding conversion.  
If you explicitly need, you can load the library on start of solution.  
  
MBS Plugin may try to load iconv.dll/dylib/so automatically when first iconv function is called.  
  
You can find a precompiled Windows library here:  
<https://www.monkeybreadsoftware.com/filemaker/files/Libs/>  
### Examples

Load library on Windows:

 MBS ( "Plugin.LoadIconvLibrary"; "C:\\Users\\Christian\\Desktop\\libiconv2.dll" )  
Load the iconv library coming with FileMaker Pro on Windows:

 MBS ( "Plugin.LoadIconvLibrary"; "libiconv.dll")  
### See also

- [Archive.Extract](ArchiveExtract.md)
- [EmailParser.ParseContainer](EmailParserParseContainer.md)
- [EmailParser.ParseFile](EmailParserParseFile.md)
- [Text.ConvertFromTextEncoding](TextConvertFromTextEncoding.md)
- [Text.ConvertToTextEncoding](TextConvertToTextEncoding.md)

### Blog Entries

- [What is new in the MBS FileMaker Plugin Version 10.4](https://www.mbsplugins.de/archive/2020-09-22/What_is_new_in_the_MBS_FileMak/monkeybreadsoftware_blog_filemaker)

This function is free to use.

Created 9th September 2020 , last changed 8th December 2025

  
[Plugin.LimitToFile](PluginLimitToFile.md) - [Plugin.LockFunction](PluginLockFunction.md)

[HTML Version](PluginLoadIconvLibrary.shtml)