GitHub |
您所在的位置:网站首页 › CSTL › GitHub |
facil.io 0.8.x - The C Server Toolbox Library (C STL)
The facil.io C STL aims to provide C developers with easy-to-use tools to write memory safe and performant programs. The C Server Toolbox Library Powers a Web microFrameworkThe facil.io library is much more than a Web Application Framework and includes core tools and type templates that any C (and C++) project will find useful. In addition to useful helpers, facil.io allows developers to use MACROS to generate code for different common types, such as Hash Maps, Arrays, Binary-Safe Strings, etc'. In other words, some of the most common building blocks one would need in any C project are placed in this convenient header file library. InstallingSimply copy the fio-stl.h file to your project's folder (using a single header file). Done. Or... copy the fio-stl folder to your project's folder (using "fio-stl/include.h"). Done. Include the file as many times as required and enjoy. Running TestsTo test the STL locally you need to first fork the project or download the whole project source code. Then, from the project's root folder run: make tests/stlThe GNU make command will compile and run any file in the tests folder if it is explicitly listed. i.e., make tests/malloc # speed test facil.io's memory allocator make tests/json # test JSON roundtrip with external JSON files make tests/json_minify # JSON minification example make tests/cpp # Test template compilation in a C++ file (no run)... may fail on some compilersIt is possible to use the same makefile to compile source code and static library code. See the makefile for details. On Windows you might want to skip the makefile (if you do not have make and gcc installed) and run: cls && cl /Ox tests\stl.c /I. && stl.exe Quick ExamplesThere are a number of examples in the ./examples folder, including: Examples for authoring network applications: Mix an HTTP/1.1 Server to serve data with a WebSockets/SSE Chat Server. A simple network client example. Pub/Sub based text Chat server. Examples using the C Server Toolbox Library (STL) Types: Creating your own Array type. Using the included copy-on-write Binary Safe Strings (bstr). Making your own reference-counted shared (binary safe) String type. using FIOBJ types with JSON for soft / mix typed data structures. Authoring your own Hash Maps for your own types. Running the example codeExamples can be compiled and executed using: make examples/For example, to compile and run the server example, use: make examples/server Contribution NoticeIf you're submitting a PR, make sure to update the corresponding code slice (file) in the fio-stl folder, the makefile will re-produce the fio-stl.h file automatically. Note that the master branch is currently as unstable as it gets. Commits may get squashed, the branch may be overwritten (force push), etc'. I will play nicer when the code stabilizes. Also, contributions are subject to the terms and conditions set in the facil.io contribution guide. DocumentationDocumentation is available in the (auto-generated) fio-stl.md file. |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |