https://github.com/copperspice/cs_string

Header-only library providing unicode aware string support for C++
https://github.com/copperspice/cs_string

copperspice cpp string unicode

Last synced: 7 days ago
JSON representation

Header-only library providing unicode aware string support for C++

• Host: GitHub
• URL: https://github.com/copperspice/cs_string
• Owner: copperspice
• License: other
• Created: 2017-05-17T14:47:59.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2025-01-21T19:23:01.000Z (28 days ago)
• Last Synced: 2025-02-04T23:35:23.592Z (14 days ago)
• Topics: copperspice, cpp, string, unicode
• Language: C++
• Homepage: https://www.copperspice.com/
• Size: 248 KB
• Stars: 108
• Watchers: 11
• Forks: 13
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## CsString

### Introduction

CsString is a standalone library which provides unicode aware string support.

The CsBasicString class is a templated class which provides unicode aware string support. The encoding, such

as UTF-8 or UTF-16, is passed to the CsBasicString template. The following typedefs are provided for convenience.

    using CsString       = CsBasicString;

    using CsString_utf8  = CsBasicString;

    using CsString_utf16 = CsBasicString;

### System Requirements

Building CsString requires a C++20 compiler and a C++20 standard library.

CMake build files are provided with the source distribution to build this library. The unit test binary executable is

an optional part of the build process.

This library has been tested with clang sanitizer and an extensive industry code review.

### Running the Catch Tests

To enable unit testing set the BUILD_TESTS in the root CMakeLists.txt file to ON. You can also configure the

setting by passing -DBUILD_TESTS=ON on the CMake command line.

If you do not have the Catch2 library installed the files can be download from our website. This is a header

only library.

https://download.copperspice.com/toolchain/catch/

Either add the path where the Catch2 files are located or pass the path using -DCMAKE_PREFIX_PATH on the CMake

command line. The following shows how to pass both arguments.

export CMAKE_FLAGS="-DBUILD_TESTS=on -DCMAKE_PREFIX_PATH=C:/Catch2/lib/cmake/Catch2"

Build this library and then run CTest in the root of your build directory.

### Documentation

Class level documentation for CsString is available on the CopperSpice website:

https://www.copperspice.com/docs/cs_string/index.html

### Presentations

Our YouTube channel contains over 75 videos about C++, programming fundamentals, Unicode/Strings, multithreading,

graphics, CopperSpice, DoxyPress, and other software development topics.

https://www.youtube.com/copperspice

Links to additional videos can be found on our website.

https://www.copperspice.com/presentations.html

### Authors / Contributors

* **Ansel Sermersheim**

* **Barbara Geller**

* **Peter Bindels**

### License

This library is released under the BSD 2-clause license. For more information refer to the LICENSE file provided with

this project.

### References

 * Website:  https://www.copperspice.com

 * Twitter:  https://twitter.com/copperspice_cpp

 * Email:    [email protected]

 * Github:   https://github.com/copperspice

 * Forum:    https://forum.copperspice.com

 * Journal:  https://journal.copperspice.com