History

Stephan Bergmann 6d1b241ab7 Drop o3tl::span, can use C++20 std::span directly now Change-Id: Ic21ff7bf48f07f7277979d52e99d2c5c268de83f Reviewed-on: https://gerrit.libreoffice.org/c/core/+/157825 Tested-by: Jenkins Reviewed-by: Stephan Bergmann <sbergman@redhat.com>		2023-10-11 21:53:13 +02:00
..
qa	Drop o3tl::span, can use C++20 std::span directly now	2023-10-11 21:53:13 +02:00
CompilerTest_o3tl_temporary.mk
CompilerTest_o3tl_unsafe_downcast.mk
CppunitTest_o3tl_tests.mk	Drop o3tl::span, can use C++20 std::span directly now	2023-10-11 21:53:13 +02:00
IwyuFilter_o3tl.yaml
Makefile
Module_o3tl.mk
README.md

README.md

LibreOffice Template Library

Very basic template functionality, a bit like boost or STL, but specific to LibreOffice.

o3tl stands for "OOo [o3, get it?] template library", in which OOo stands for OpenOffice.org, predecessor of LibreOffice.

From https://blog.thebehrens.net/2006/01/15/update-cow_wrapper-is-available-now/ The scope for o3tl is admittedly kind of ambitious, as it should contain "...very basic (template) functionality, comparable to what's provided by boost or stl, but specific to OOo (what comes to mind are e.g. STL adapters for our own data types and UNO, and stuff that could in principle be upstreamed to boost, but isn't as of now)."

Class Overview

[git:include/o3tl/cow_wrapper.hxx]

A copy-on-write wrapper.
[git:include/o3tl/lazy_update.hxx]

This template collects data in input type, and updates the output type with the given update functor, but only if the output is requested. Useful if updating is expensive, or input changes frequently, but output is only comparatively seldom used.
[git:include/o3tl/vector_pool.hxx]

Simple vector-based memory pool allocator.
[git:include/o3tl/functional.hxx]

Some more templates, leftovers in spirit of STLport's old functional header that are not part of the C++ standard (STLport has been replaced by direct use of the C++ STL in LibreOffice).