Hackage :: [Package]

language-c-inline: Inline C & Objective-C code in Haskell for language interoperability

[ bsd3, foreign, language, library ] [ Propose Tags ]

This library provides inline C & Objective-C code using GHC's support for quasi-quotation. In particular, it enables the use of foreign libraries without a dedicated bridge or binding. Here is a tiny example:

nslog :: String -> IO ()
nslog msg = $(objc ['msg] ''() [cexp| NSLog(@"Here is a message from Haskell: %@", msg) |])

For more information, see https://github.com/mchakravarty/language-c-inline/wiki.

Known bugs: https://github.com/mchakravarty/language-c-inline/issues

  • New in 0.3.0.0: Boxed Haskell types without a dedicated type mapping are marshalled using stable pointers.

  • New in 0.2.0.0: Support for multiple free variables in one inline expression as well as for inline code returning void.

  • New in 0.1.0.0: We are just getting started! This is just a ROUGH AND HIGHLY EXPERIMENTAL PROTOTYPE.

[Skip to Readme]

Modules

[Index]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.3.0.0, 0.3.0.1, 0.5.0.0, 0.6.0.0, 0.7.6.0, 0.7.6.1, 0.7.7.0, 0.7.8.0, 0.7.9.0, 0.7.9.1, 0.7.9.2, 0.7.10.0, 0.7.11.0 (info)
Dependencies array, base (>=4.0 && <5), filepath (>=1.2), language-c-quote (>=0.7), mainland-pretty (>=0.2.5), template-haskell [details]
License BSD-3-Clause
Author Manuel M T Chakravarty
Maintainer Manuel M T Chakravarty <chak@justtesting.org>
Category Language, Foreign
Home page https://github.com/mchakravarty/language-c-inline/
Bug tracker https://github.com/mchakravarty/language-c-inline/issues
Source repo head: git clone git://github.com/mchakravarty/language-c-inline.git
Uploaded by ManuelChakravarty at 2014-01-21T04:08:06Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Downloads 9561 total (32 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Successful builds reported [all 1 reports]

Readme for language-c-inline-0.3.0.1

[back to package description]

Inline C & Objective-C in Haskell

This library uses Template Haskell and language-c-quote, a quasi-quotation library for C-like languages, to provide inline C and Objective-C in Haskell. It extracts the C/Objective-C code automatically, when compiling the Haskell program, and generates marshalling code for common types. The wiki on GitHub details the motivation for this approach.

Building

To build the library, just use cabal install as usual from the source code directory or by installing from Hackage.

You may like to have a look at a minimal example of its use, which you can build as follows:

  • Execute cd tests/objc/minimal; make.
  • Now run the demo executable with ./Minimal.

To build the proof of concept example, do the following:

  • Execute cd tests/objc/concept; make.
  • Now run the demo executable with ./InlineObjC.

To build the more complex Haskell interpreter app:

  • Execute cd tests/objc/app; make.
  • Now open -a HSApp.app.

I tested it with Haskell Platform 2013.2.0.0 (which includes GHC 7.6.3) and it requires the latest version of language-c-quote, which is 0.7.6.

Status

The library is still in its early stages. At the moment automatic marshalling support is limited to strings and boxed Haskell values represented as stable pointers in C land. However, it is quite easy to add more types, and I do welcome pull request!