به نام خدا
مقدمه:
Log4z یک کتابخانه گزارش گیری(log) سبک برای ++C و به صورت منبع باز است. به وسیله این کتابخانه در برنامه های ++C می توانید از رفع اشکال کد (debug) گزارش گرفته و آن را trace کنید. استفاده از log4z در گزارش گیری و دنبال کردن اطلاعاتی که در صفحه نمایش وجود دارد و قصد دارید آن را به به فایل گزارش خود یا همان log file انتقال دهید، بسیار ساده و مناسب است.
آدرس سایت منبع باز:
https://github.com/zsummer/log4z
Log4z的优点
مزایای log4z عبارتند از:
۱. گواهینامه و جواز منبع باز آن دارای گستره وسیعی است و می تواند در موارد شخصی، آموزشی و تجاری مورد استفاده قرار گیرد.
۲. log4z بسیار سبک است. با استفاده از ++C و APIهای سیستمی تنها با نوشتن یک فایل هدر و سورس فایل ++C به کارگیری آن بسیار ساده و آسان می باشد.
۳. جهت خروجی گرفتن از گزارش در برنامه های چند وظیفه ای(multithreading) برای پلتفرم های مختلف (شامل ویندوز یا لینوکس و ۳۲ یا ۶۴بیت) سازگار می باشد.
۴. جهت فراهم کردن کنترل اولویت دهی به گزارش ها و روند ها می تواند در هر موقعیتی تنظیم شود.
۵. تنظیمات مربوط به افزایش ثبت کننده گزارش های مختلف از طریق فراخوانی رابط ها یا فایل تنظیمات.
۶. نمایش خروجی بر اساس اولویت های مختلف با امکان رنگ بندی در نمایش آن ها. خروجی را می توان با توجه به نیاز خصوصی سازی و خلاصه کرد. همچنین رابط گزارش گیری سریع و راحت است.
۷. کارآیی عالی و استفاده بهینه از حافظه.
۸. رابط کاربری آن ساده و آسان است. هر برنامه نویس ماهری تنها با مشاهده واسط log4z.h می تواند نحوه گزارش گیری آن را درک کند.
update logs
/*
* UPDATES
*
* VERSION 0.1.0 <DATE: 2010.10.4>
* create the first project.
* It support put log to screen and files,
* support log level, support one day one log file.
* support multiple thread, multiple operating system.
*
* VERSION .... <DATE: ...>
* ...
*
* VERSION 0.9.0 <DATE: 2012.12.24>
* support config files.
* support color text in screen.
* support multiple logger.
*
* VERSION 1.0.0 <DATE: 2012.12.29>
* support comments in the config file.
* add a advanced demo in the ./project
* fix some details.
*/
راهنمای کاربری سریع:
۱. ابتدا log4z.h را include کنید.
۲. استفاده از namespaceمناسب
using namespace zsummer::log4z;
۳. اضافه کردن یک گزارش گیر. اگر این کار را انجام ندهید تنها یک گزارش گیر اصلی وجود خواهد داشت.
ILog4zManager::GetInstance()->AddLogger(1,"", "AddLogger", LOG_DEBUG);
۴. log4z را شروع کنید.
ILog4zManager::GetInstance()->Start();
۵. ثبت گزارش گیری:LOGD LOGI LOGE این کار باعث می شود تا گزارش گیر اصلی را ثبت کند و سطح آن LOG DEBUG, LOG INFO است. مثال:
LOGD("this is a LOG_DEBUG level's log, " << " ^_^ " );
۶. توقف و بستن آن. Log4z به صورت خودکار بعد از پایان پردازش متوقف و بسته می شود.
//ILog4zManager::GetInstance()->Stop()
کامپایل:
در Visual Studio فایل .h و .cpp آن را به برنامه الحاق کنید.
در لینوکس به افزودن -lpthread احتیاج دارید. مثال:
g++ -lpthread -o test main.cpp ../log4z.cpp
تغییراتlog4z در نسخه 1.0.1
۱. سورس کد آن هیچ تغییری پیدا نکرده است.
۲.بعضی از commentها در log4z درست شده است.
۳.تعدادی comment به پروژه آزمایشی آن اضافه شده است.
۴. بعضی از کدهای اضافی در 'fast_test' اضافه شده که باعث آسان تر شدن آن شده است.
دانلود فایل های پیوست:
منبع: سایت cplusplus.com نوشته zsummer
ترجمه و ویرایش: مرجع فارسی سی پلاس پلاس به آدرس cplusplus.ir
عکس از DEMO
عکس از Screen
نظرات بعد از بررسی در سایت درج خواهند شد.
مطمئنا از شنیدن انتقادهای شما خوشحال خواهیم شد.
دلیل فیلتر کردن نظرات صرفا جلوگیری از نظرات مغایر با اسلام و جمهوری اسلامی ایران می باشد. امیدواریم ما را به خاطر این کار درک نمایید. با تشکر