1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53
|
# iconv
[![Build Status](https://travis-ci.org/processone/iconv.svg?branch=master)](https://travis-ci.org/processone/iconv) [![Coverage Status](https://coveralls.io/repos/processone/iconv/badge.svg?branch=master&service=github)](https://coveralls.io/github/processone/iconv?branch=master) [![Hex version](https://img.shields.io/hexpm/v/iconv.svg "Hex version")](https://hex.pm/packages/)
Fast encoding conversion library for Erlang / Elixir
This library is a native binding to
[libiconv](https://www.gnu.org/software/libiconv/) library.
## Building
iconv library can be build as follow:
./configure && make
iconv is a rebar-compatible OTP application. Alternatively, you can
build it with rebar:
rebar compile
## Dependencies
iconv library depends on libiconv.
You can use `configure` option to pass custom path to libiconv
library:
--with-libiconv-prefix[=DIR] search for libiconv in DIR/include and DIR/lib
## Usage
You can start iconv with the following command:
```shell
$ erl -pa ebin
Erlang/OTP 17 [erts-6.3] [source] [64-bit] [smp:4:4] [async-threads:10] [hipe] [kernel-poll:false] [dtrace]
Eshell V6.3 (abort with ^G)
% Start the application:
1> application:start(iconv).
```
## Development
### Test
#### Unit test
You can run eunit test with the command:
$ rebar eunit
|