mirror of
https://github.com/boostorg/static_string.git
synced 2025-07-29 12:07:42 +02:00
Work on docs
This commit is contained in:
@ -1,6 +1,6 @@
|
||||
[/
|
||||
Copyright (c) 2016-2019 Vinnie Falco (vinnie dot falco at gmail dot com)
|
||||
Copyright (c) 2019 Krystian Stasiowski (sdkrystian at gmail dot com)
|
||||
Copyright (c) 2019-2020 Krystian Stasiowski (sdkrystian at gmail dot com)
|
||||
|
||||
Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||
file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||
@ -12,7 +12,7 @@
|
||||
[id static_string]
|
||||
[quickbook 1.6]
|
||||
[copyright 2016 - 2019 Vinnie Falco]
|
||||
[copyright 2019 Krystian Stasiowski]
|
||||
[copyright 2019 - 2020 Krystian Stasiowski]
|
||||
[purpose String Library]
|
||||
[license
|
||||
Distributed under the Boost Software License, Version 1.0.
|
||||
@ -40,7 +40,7 @@
|
||||
This library provides a dynamically resizable string of characters with
|
||||
compile-time fixed capacity and contiguous embedded storage in which the
|
||||
characters are placed within the string object itself. Its API closely
|
||||
resembles that of `std::string`
|
||||
resembles that of `std::string`.
|
||||
|
||||
[/-----------------------------------------------------------------------------]
|
||||
|
||||
@ -78,7 +78,8 @@ algorithms which throw exceptions provide the strong exception safety
|
||||
guarantee. This is intended to be a drop in replacement for `std::string`.
|
||||
|
||||
The API of `static_string` only diverges from `std::string` in few places,
|
||||
being `substr` for which this implementation returns a string view instead of `static_string`,
|
||||
one of which is the addition of the `subview` function, for which this implementation
|
||||
returns a string view instead of `static_string`,
|
||||
and certain functions that will never throw are marked as `noexcept`, which diverges from
|
||||
those of `std::string`. The available overloads for `static_string` are identical to those
|
||||
of `std::string`.
|
||||
@ -96,9 +97,9 @@ The iterator invalidation rules differ from those of `std::string`:
|
||||
|
||||
[heading Optimizations]
|
||||
|
||||
Depending on the character type and size used for a specialization of `static_string`, certain optimizations are used to reduce the size of the class type. Given the name of a specialization of the form `static_string<N, CharT, Traits>`:
|
||||
Depending on the character type and size used for a specialization of `static_string`, certain optimizations are used to reduce the size of the class type. Given the name of a specialization of the form `basic_static_string<N, CharT, Traits>`:
|
||||
|
||||
* If `N` is 0, then the class has no non-static data members. Given two objects `a` and `b` of type `static_string<0, T>` and `static_string<0, U>` respectively, the pointer value returned by `data()` will be the same if `T` and `U` are the same.
|
||||
* If `N` is 0, then the class has no non-static data members. Given two objects `a` and `b` of type `basic_static_string<0, T, Traits>` and `static_string<0, U, Traits>` respectively, the pointer value returned by `data()` will be the same if `T` and `U` are the same.
|
||||
|
||||
* Otherwise, the type of the member used to store the size of the `static_string` will be the smallest standard unsigned integer type that can represent the value `N`.
|
||||
|
||||
@ -112,9 +113,19 @@ Certain features can be enabled and disabled though defining configuration macro
|
||||
|
||||
[/-----------------------------------------------------------------------------]
|
||||
|
||||
[heading Acknowledgments]
|
||||
|
||||
Thanks to [@@https://github.com/K-ballo Agustín Bergé], [@https://github.com/pdimov Peter Dimov], [@https://github.com/glenfe Glen Fernandes], and [@https://github.com/LeonineKing1199 Christian Mazakas] for their constant feedback and guidance during the development of this library.
|
||||
|
||||
The development of this library was sponsored by [@https://cppalliance.org The C++ Alliance].
|
||||
|
||||
[/-----------------------------------------------------------------------------]
|
||||
|
||||
[heading Reference]
|
||||
|
||||
[link static_string.ref.boost__static_string__static_string `static_string`]
|
||||
Defined in namespace `boost::static_strings`:
|
||||
|
||||
[link static_string.ref.boost__static_strings__basic_static_string `basic_static_string`]
|
||||
|
||||
[/-----------------------------------------------------------------------------]
|
||||
|
||||
@ -124,4 +135,4 @@ Certain features can be enabled and disabled though defining configuration macro
|
||||
|
||||
[/-----------------------------------------------------------------------------]
|
||||
|
||||
[xinclude index.xml]
|
||||
[xinclude index.xml]
|
@ -1,6 +1,6 @@
|
||||
<!-- Variables (Edit for your project) -->
|
||||
<xsl:variable name="doc-ref" select="'static_string.ref.'"/>
|
||||
<xsl:variable name="doc-ns" select="'boost::static_string'"/>
|
||||
<xsl:variable name="doc-ns" select="'boost::static_strings'"/>
|
||||
<xsl:variable name="debug" select="0"/>
|
||||
<xsl:variable name="private" select="0"/>
|
||||
<!-- End Variables -->
|
||||
|
@ -2,7 +2,7 @@
|
||||
"key": "static_string",
|
||||
"name": "StaticString",
|
||||
"authors": [
|
||||
"Vinnie Falco"
|
||||
"Vinnie Falco",
|
||||
"Krystian Stasiowski"
|
||||
],
|
||||
"description": "A fixed capacity dynamically sized string.",
|
||||
|
Reference in New Issue
Block a user