mirror/fmt
1
0
Fork 0
mirror of https://github.com/fmtlib/fmt.git synced 2024-12-24 03:17:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

Use one namespace (fmt) instead of two (format and fmt).

Browse Source
This commit is contained in:
Victor Zverovich 2013-01-21 11:42:25 -08:00
parent 1b3ac76019
commit a1dccea9ba
3 changed files with 21 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/conf.py
View File

@ -54,9 +54,9 @@ copyright = u'1990-2012, Python Software Foundation'
# built documents.
#
# The short X.Y version.
version = '0.4'
version = '0.5'
# The full version, including alpha/beta/rc tags.
release = '0.4'
release = '0.5'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.

16
doc/index.rst
View File

@ -5,30 +5,30 @@
String Formatting API
---------------------
.. doxygenfunction:: format::Format(StringRef)
.. doxygenfunction:: fmt::Format(StringRef)
.. doxygenclass:: format::Formatter
.. doxygenclass:: fmt::Formatter
:members:
.. doxygenclass:: format::TempFormatter
.. doxygenclass:: fmt::TempFormatter
:members:
.. doxygenclass:: format::NoAction
.. doxygenclass:: fmt::NoAction
:members:
.. doxygenclass:: format::StringRef
.. doxygenclass:: fmt::StringRef
:members:
.. doxygenfunction:: format::str
.. doxygenfunction:: fmt::str
.. doxygenfunction:: format::c_str
.. doxygenfunction:: fmt::c_str
.. _formatstrings:
Format String Syntax
--------------------
The :cpp:func:`format::Format()` function and the :cpp:class:`format::Formatter`
The :cpp:func:`fmt::Format()` function and the :cpp:class:`fmt::Formatter`
class share the same syntax for format strings.
Format strings contain "replacement fields" surrounded by curly braces ``{}``.

25
format.h
View File

@ -38,7 +38,7 @@
#include <sstream>
#include <vector>
namespace format {
namespace fmt {
namespace internal {
@ -439,8 +439,7 @@ BasicFormatter &BasicFormatter::operator<<(const IntFormatter<T, Spec> &f) {
switch (f.type()) {
case 0: case 'd': {
unsigned num_digits = BasicFormatter::CountDigits(abs_value);
char *p = PrepareFilledBuffer(size + num_digits, f, sign)
- num_digits + 1;
char *p = PrepareFilledBuffer(size + num_digits, f, sign) - num_digits + 1;
BasicFormatter::FormatDecimal(p, abs_value, num_digits);
break;
}
@ -497,7 +496,7 @@ void Format(BasicFormatter &f, const FormatSpec &spec, const T &value) {
/**
\rst
The :cpp:class:`format::Formatter` class provides string formatting
The :cpp:class:`fmt::Formatter` class provides string formatting
functionality similar to Python's `str.format
<http://docs.python.org/3/library/stdtypes.html#str.format>`__.
The output is stored in a memory buffer that grows dynamically.
@ -677,8 +676,8 @@ const char *c_str(internal::FormatterProxy p);
namespace internal {
using format::str;
using format::c_str;
using fmt::str;
using fmt::c_str;
class FormatterProxy {
private:
@ -701,8 +700,8 @@ class ArgInserter {
private:
mutable Formatter *formatter_;
friend class format::Formatter;
friend class format::StringRef;
friend class fmt::Formatter;
friend class fmt::StringRef;
// Do not implement.
void operator=(const ArgInserter& other);
@ -821,8 +820,8 @@ class TempFormatter : public internal::ArgInserter {
\rst
Constructs a temporary formatter with a format string and an action.
The action should be an unary function object that takes a const
reference to :cpp:class:`format::Formatter` as an argument.
See :cpp:class:`format::NoAction` and :cpp:class:`format::Write` for
reference to :cpp:class:`fmt::Formatter` as an argument.
See :cpp:class:`fmt::NoAction` and :cpp:class:`fmt::Write` for
examples of action classes.
\endrst
*/
@ -864,8 +863,8 @@ class TempFormatter : public internal::ArgInserter {
literal text and replacement fields surrounded by braces ``{}``.
The formatter object replaces the fields with formatted arguments
and stores the output in a memory buffer. The content of the buffer can
be converted to ``std::string`` with :cpp:func:`format::str()` or
accessed as a C string with :cpp:func:`format::c_str()`.
be converted to ``std::string`` with :cpp:func:`fmt::str()` or
accessed as a C string with :cpp:func:`fmt::c_str()`.
**Example**::
@ -893,6 +892,4 @@ inline TempFormatter<Write> Print(StringRef format) {
}
}
namespace fmt = format;
#endif // FORMAT_H_