cmn-clib（C言語ライブラリ）

cmn-clibは、オープンソースのC言語用関数ライブラリで、Windows/Linuxのマルチ環境で開発／利用が可能です。

日々の開発を通じて共通化してきた関数群をオープンソースのライブラリとしてまとめたものですが、継続して開発を行っているため、関数の追加や変更が発生する可能性は大いにあり、現在はベータ版となります。

開発／利用環境

• Windows
  開発ツールはVisualStudio(2019)もしくはEclipse(MinGw)。
  DLLもしくはStatic-libとしてリンクして利用可能。
  ※DLL生成は現在未対応です。DLL生成が必要な場合はDLL用にビルド設定を変える必要があります。
• Linux
  開発ツールはgccおよびmakeです。
  利用はarからのスタティックリンクです。
  そのうちsoとしてダイナミックリンク可能にする予定ですが、まだ出来ていません。
• MacOS
  自分がMac使ってないので対象外ですが、gcc+makeで標準C/C++ライブラリくらいしか使っていないのでMacでもビルドできると思います。
  あ、一部ファイル操作かソケット通信でLinux用ライブラリ使ってしまっているかもしれません。

cmn-clib の利用方法

バイナリ配布を利用する

コンパイル済みのバイナリは、Windows/Linuxの64bit向けのみとなります。

バイナリダウンロード / Download

スタティックリンク / static link

バイナリをダウンロードして任意の場所に解凍し、ご自分のプログラムに組み込んでください。

• inc：ヘッダーファイルです。
• cmn-clib.lib（Windowsの場合）：スタティックリンクライブラリです。
• libcmn-clib.a（Linuxの場合）：スタティックリンクライブラリです。

Visual Studio の場合

プロジェクトのプロパティを開き、以下を設定します。

1. [C/C++] -> [全般] -> [追加のインクルードディレクトリ]に、解凍したcmn-clibの「inc」ディレクトリのパスを追加。
2. [リンカー] -> [入力] -> [追加の依存ファイル]に、解凍したcmn-clibの「cmn-clib.lib」のパスを追加。
3. プログラムソースコードに #include<cmnclib.h> を追加する。

gcc の場合

プログラムソースコードに #include<cmnclib.h> を追加し、以下の要領でビルドしてください。

$ gcc YourSource.c -I/{解凍場所}/inc -L/{解凍場所} -lcmn-clib -pthread

「YourSource.c」はご自分のプログラムです。最後に「-pthread」をつけているのは、cmn-clibではマルチスレッド機能を提供しており、Linuxのマルチスレッドライブラリを使っているためです。
マルチスレッド機能を使わなくてもリンクするために必須になってしまうので、イマイチな部分ですね。今後なんらか対策を考えようと思います。

ダイナミックリンク

cmn-clibはまだダイナミックリンクに対応できていません。今後対応する予定です。

ソースコードからビルドする

ソースコードはgithubで管理しています。

GitHub - kumagaihs/cmn-clib: C/C++用の関数ライブラリ＆ツールです。Windows/Linuxのマルチプラットフォームで開発・利用が可能です。

C/C++用の関数ライブラリ＆ツールです。Windows/Linuxのマルチプラットフォームで開発・利用が可能です。 - kumagaihs/cmn-clib

github.com

VisualStudioの場合

VisualStudioのソリューションファイル「cmn-clib.sln」がありますので、git clone もしくはソースコードをダウンロードしてもらえば、そのままビルド出来ます。

ビルドターゲットを「static-lib」にしてcmn-clibプロジェクトをビルドすると、ライブラリが生成されます。尚、ビルドターゲット「Debug」と「Release」はcmn-clibのユニットテストを実行するEXEが生成されるビルドですので、ライブラリを生成したい場合は「static-lib」をビルドしてください。

cmn-clibの動作確認をする場合は、ビルドターゲットを「Debug」か「Release」にして、cmn-clibをF5で実行してください。

以降、ご自分のプログラムにcmn-clibを組み込む方法はバイナリ配布の手順と同様となります。

Linuxの場合

Makefileを用意していますので、git cloneもしくはソースコードダウンロードから「make」でビルド出来ます。

$ git clone https://github.com/kumagaihs/cmn-clib.git
$ cd cmn-clib/cmn-clib
$ make

# 動作確認
$ build/test_main

以降、ご自分のプログラムにcmn-clibを組み込む方法はバイナリ配布の手順と同様となります。

サブプロジェクトの概要

cmn-clibはいくつかのサブプロジェクトを内包しています。
メインとなるのは「cmn-clib」で、こちらがC言語ライブラリです。

• cmn-clib
  C言語用ライブラリ。「extern “C”」すればC++から利用することも可能です。（当たり前か）
  VisualStudio用のプロジェクトファイルとEclipse（MinGw）向けのプロジェクトファイルが同居しているのでどちらでも開発可能です。
  ただし主にWindowsではVisualStudio、Linuxではgccでビルドしているので、MinGwでは警告が出る場合があるかもしれません。
  （たまにMinGwでビルドしてみて気が付いたら直していますが）
  なのでVisualStudioもしくはLinuxでの利用がおすすめです。
  ビルド方法・利用方法はソースコード内の/cmn-clib/readme.txtを参照してください。
  （ソースコードはgithub管理です。下にリンクあります。）
• cmn-cpplib
  C++用ライブラリ。ただまだ作りはじめでほとんど中身空っぽです。
• cmn-tools CUIベースのツール群です。
  こちらはC++で開発しています。

cmn-clib（C言語ライブラリ）の詳細仕様

API-Documents

APIドキュメントはDoxygenで生成しています。

cmn-clib APIドキュメント

関数一覧

cmn-clibが持つ関数の一覧です。詳細はAPIドキュメントをご参照ください。

cmn-tools（CUIツール群）詳細

cmn-toolsは、cmn-clibを使って開発されたコマンドラインツール群です。

cmn-toolsの各機能はサブコマンドとして実装されており、使用方法は以下のようになります。

$ cmn-tools サブコマンド名 [オプション]

サブコマンド一覧

cmn-clibへのご要望・カスタマイズについて

C言語ライブラリ「cmn-clib」へのご要望やカスタマイズのご相談は、お問い合わせページよりお願い致します。

お問い合わせ

当サイトへのお問い合わせは、以下のフォームからお受けしております。

ityorozu.net

2021.12.27