mirror/fmt
1
0
Fork 0
mirror of https://github.com/fmtlib/fmt.git synced 2024-12-27 12:38:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update docs

Browse Source
This commit is contained in:
Victor Zverovich 2021-06-02 08:06:52 -07:00
parent faf972f039
commit cbd861f188
1 changed files with 18 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
doc/api.rst
View File

@ -19,6 +19,7 @@ The {fmt} library API consists of the following parts:
* :ref:`fmt/os.h <os-api>`: system APIs * :ref:`fmt/os.h <os-api>`: system APIs
* :ref:`fmt/ostream.h <ostream-api>`: ``std::ostream`` support * :ref:`fmt/ostream.h <ostream-api>`: ``std::ostream`` support
* :ref:`fmt/printf.h <printf-api>`: ``printf`` formatting * :ref:`fmt/printf.h <printf-api>`: ``printf`` formatting
* :ref:`fmt/xchar.h <xchar-api>`: optional ``wchar_t`` support
All functions and types provided by the library reside in namespace ``fmt`` and All functions and types provided by the library reside in namespace ``fmt`` and
macros have prefix ``FMT_``. macros have prefix ``FMT_``.
@ -49,7 +50,7 @@ participate in an overload resolution if the latter is not a string.
.. doxygenfunction:: format(format_string<T...> fmt, T&&... args) -> std::string .. doxygenfunction:: format(format_string<T...> fmt, T&&... args) -> std::string
.. doxygenfunction:: vformat(string_view fmt, format_args args) -> std::string .. doxygenfunction:: vformat(string_view fmt, format_args args) -> std::string
.. doxygenfunction:: format_to(OutputIt out, format_string<T...> fmt, T&& args) -> OutputIt .. doxygenfunction:: format_to(OutputIt out, format_string<T...> fmt, T&&... args) -> OutputIt
.. doxygenfunction:: format_to_n(OutputIt out, size_t n, format_string<T...> fmt, const T&... args) -> format_to_n_result<OutputIt> .. doxygenfunction:: format_to_n(OutputIt out, size_t n, format_string<T...> fmt, const T&... args) -> format_to_n_result<OutputIt>
.. doxygenfunction:: formatted_size(format_string<T...> fmt, T&&... args) -> size_t .. doxygenfunction:: formatted_size(format_string<T...> fmt, T&&... args) -> size_t
@ -123,7 +124,6 @@ times and reduces binary code size compared to a fully parameterized version.
:members: :members:
.. doxygentypedef:: fmt::format_context .. doxygentypedef:: fmt::format_context
.. doxygentypedef:: fmt::wformat_context
Compatibility Compatibility
------------- -------------
@ -132,7 +132,6 @@ Compatibility
:members: :members:
.. doxygentypedef:: fmt::string_view .. doxygentypedef:: fmt::string_view
.. doxygentypedef:: fmt::wstring_view
Locale Locale
------ ------
@ -297,15 +296,13 @@ Literal-based API
The following user-defined literals are defined in ``fmt/format.h``. The following user-defined literals are defined in ``fmt/format.h``.
.. doxygenfunction:: operator""_format(const char *s, size_t n) .. doxygenfunction:: operator""_format(const char *s, size_t n) -> detail::udl_formatter<char>
.. doxygenfunction:: operator""_a(const char *s, size_t) .. doxygenfunction:: operator""_a(const char *s, size_t) -> detail::udl_arg<char>
Utilities Utilities
--------- ---------
.. doxygenstruct:: fmt::is_char
.. doxygentypedef:: fmt::char_t .. doxygentypedef:: fmt::char_t
.. doxygenfunction:: fmt::ptr(const T *p) .. doxygenfunction:: fmt::ptr(const T *p)
@ -315,8 +312,6 @@ Utilities
.. doxygenfunction:: fmt::to_string(const T &value) .. doxygenfunction:: fmt::to_string(const T &value)
.. doxygenfunction:: fmt::to_wstring(const T &value)
.. doxygenfunction:: fmt::to_string_view(const Char *s) .. doxygenfunction:: fmt::to_string_view(const Char *s)
.. doxygenfunction:: fmt::join(Range &&range, string_view sep) .. doxygenfunction:: fmt::join(Range &&range, string_view sep)
@ -526,6 +521,20 @@ argument type doesn't match its format specification.
.. doxygenfunction:: sprintf(const S&, const Args&...) .. doxygenfunction:: sprintf(const S&, const Args&...)
``wchar_t`` Support
===================
The optional header ``fmt/wchar_t.h`` provides support for ``wchar_t`` and
exotic character types.
.. doxygenstruct:: fmt::is_char
.. doxygentypedef:: fmt::wstring_view
.. doxygentypedef:: fmt::wformat_context
.. doxygenfunction:: fmt::to_wstring(const T &value)
Compatibility with C++20 ``std::format`` Compatibility with C++20 ``std::format``
======================================== ========================================