https://github.com/m13253/libwintf8
The library handling things related to UTF-8 and Unicode when you want to port your program to Windows
https://github.com/m13253/libwintf8
unicode utf-8 windows
Last synced: about 1 year ago
JSON representation
The library handling things related to UTF-8 and Unicode when you want to port your program to Windows
- Host: GitHub
- URL: https://github.com/m13253/libwintf8
- Owner: m13253
- License: other
- Created: 2014-10-31T16:03:31.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2017-01-13T06:02:32.000Z (over 9 years ago)
- Last Synced: 2025-03-28T04:34:52.879Z (over 1 year ago)
- Topics: unicode, utf-8, windows
- Language: C++
- Size: 142 KB
- Stars: 16
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: COPYING
Awesome Lists containing this project
README
libWinTF8
=========
LibWinTF8 is the library handling things related to UTF-8 and Unicode when you want to port your program to Windows.
## Compiling
You need a C++ 11 compliant compiler (GCC / Clang) or MSVC (at least version 12, that is Visual Studio 2013) and CMake to build this library.
On POSIX compatible systems with GCC toolchain, run `./configure && make` to build it.
On Windows with MSVC toolchain, generate a Visual Studio solution from `CMakeLists.txt` and build it.
Considering the C++ ABI compatibility issue, it is recommended to use the same compiler to build libWinTF8 as well as other parts of your software.
## Usage
Upon successful installation, you will be able to access all the functionality with C or C++ by including `libwintf8.h`
Every C++ function is under the `WTF8` namespace.
Every C function is prefixed with `WTF8_`.
## Demo
The following is a simple `cat` program, supporting UTF-8 filename and Unicode output.
```c++
#include
#include
#include
/* Set the Windows console font to Lucida Console, which is the only console font supporting Unicode characters. */
static WTF8::SetConsoleFont set_console_font;
int main() {
/* WTF8::u8string inherits std::string. In addition to useful conversion methods, introducing a new type makes sure that different encodings do not mix up. */
std::vector argv = WTF8::getargv();
if(argv.size() < 2) {
WTF8::cerr << "Usage: " << argv[0] << " filename" << std::endl;
return 1;
}
/* WTF8::ifstream / ofstream / fstream accept WTF8::u8string as file name. */
WTF8::u8string filename = argv[1];
WTF8::ifstream fileobj(filename);
if(!fileobj.is_open()) {
WTF8::cerr << "Error: unable to open file '" << filename << "'" << std::endl;
return 2;
}
/* WTF8::cin / cout / cerr / clog use UTF-8 text. */
char c;
while(fileobj.get(c))
WTF8::cout << c;
return 0;
}
```
## Documentation
This project is in early development and the documentation is not finished yet. If you enjoy libWinTF8, consider helping me to document it.
Alternatively you can browse and read the source code to understand how it works.
## License
This software is licensed under BSD license. Refer to the [COPYING](COPYING) file for more information.