TinyJS_TRACE.c

//
//	TinyJS - A single-file Javascript-alike engine
//
//	Authored By Gordon Williams <gw@pur3.co.uk>
//	Copyright (C) 2009 Pur3 Ltd
//
//	Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
//	The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
//
//	THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
//	IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//
//-----------------------------------------------------------------------------
//
//	TinyJS(移植版)
//
//	Ported By Naoyuki Sawa <nsawa@piece-me.org>
//	Copyright (C) 2018 Piece Lab.
//
//	* Fri Mar 30 23:59:59 JST 2018 Naoyuki Sawa
//	- 1st リリース。
//	- 「TinyJS」(https://github.com/gfwilliams/tiny-js)を、P/ECEで動作するように移植したものです。
//	  オリジナル版のTinyJSはC++で書かれていますが、P/ECE開発環境にはGCC 2.7.2相当のCコンパイラしか無いので、C++からC言語に移植しました。
//	  C++とC言語はだいぶん違うため、コードはほぼ全て書き換えてしまいましたが、アルゴリズムはオリジナル版のTinyJSとだいたい同じままです。
//	  尚、メインターゲットはP/ECEですが、(少なくとも現時点では)Visual Studio 2017と、Visual C++ 6.0でもビルド出来ています。
//	- オリジナル版のTinyJSは明示的なメモリ管理を行っていますが、移植版ではガーベージコレクターの使用を前提としてメモリ管理を省きました。
//	  P/ECEの場合はclipbmgc.c,又は,clipgc.cモジュールを，Windowsの場合はBoehm GCを使用して下さい。
//	- オリジナル版のTinyJSを、/clip/keep/tiny-js-master.7z に保存しておきました。
//	  (Latest commit 56a0c6d on Mar 24 2015。2018/03/30時点の最新リビジョンです。)
//
#include "clip.h"
//-----------------------------------------------------------------------------
//TinyJS.cモジュールが文字列を出力する方法をアプリケーション毎に変更出来るようにするために、TinyJS_TRACE()関数だけを別モジュール(TinyJS_TRACE.c)に分離しました。
//オリジナル版のTinyJSでは、TRACEマクロとしてライブラリのビルド時に変更出来るようになっていましたが、ライブラリのビルド時ではなくアプリケーションのビルド時に変更したいと思ったからです。
//デフォルトのTinyJS_TRACE()は、TinyJS_TRACE.cにて、stdoutに文字列を出力するだけの関数として定義してあります。
//アプリケーション側でTinyJS_TRACE()を再定義すると、TinyJS_TRACE.cはリンクされず、アプリケーション側で定義したTinyJS_TRACE()が呼び出されます。
//TinyJS_TRACE()を再定義出来るようにした理由は、主に、P/ECE環境のためです。(P/ECE環境では、stdoutはUSBに送出されて、画面には表示されないから。)
//Windows環境の場合は、デフォルトの動作のままで特に不都合は無いので、敢えてTinyJS_TRACE()を再定義する必要はあまり無いと思います。
void TinyJS_TRACE(const char* msg) {
	fputs(msg, stdout);
}