mirror of
https://github.com/RGBCube/serenity
synced 2025-07-27 04:27:45 +00:00
Everywhere: Rename {Deprecated => Byte}String
This commit un-deprecates DeprecatedString, and repurposes it as a byte string. As the null state has already been removed, there are no other particularly hairy blockers in repurposing this type as a byte string (what it _really_ is). This commit is auto-generated: $ xs=$(ack -l \bDeprecatedString\b\|deprecated_string AK Userland \ Meta Ports Ladybird Tests Kernel) $ perl -pie 's/\bDeprecatedString\b/ByteString/g; s/deprecated_string/byte_string/g' $xs $ clang-format --style=file -i \ $(git diff --name-only | grep \.cpp\|\.h) $ gn format $(git ls-files '*.gn' '*.gni')
This commit is contained in:
parent
38d62563b3
commit
5e1499d104
1615 changed files with 10257 additions and 10257 deletions
|
@ -1,6 +1,6 @@
|
|||
# String Formatting
|
||||
|
||||
Many places in Serenity allow you to format strings, similar to `printf()`, for example `DeprecatedString::formatted()`
|
||||
Many places in Serenity allow you to format strings, similar to `printf()`, for example `ByteString::formatted()`
|
||||
, `StringBuilder::appendff()`, or `dbgln()`. These are checked at compile time to ensure the format string matches the
|
||||
number of parameters. The syntax is largely based on
|
||||
the [C++ `std::formatter` syntax](https://en.cppreference.com/w/cpp/utility/format/formatter#Standard_format_specification)
|
||||
|
@ -10,27 +10,27 @@ For basic usage, any occurrences of `{}` in the format string are replaced with
|
|||
form, in order:
|
||||
|
||||
```c++
|
||||
DeprecatedString::formatted("Well, {} my {} friends!", "hello", 42) == "Well, hello my 42 friends!";
|
||||
ByteString::formatted("Well, {} my {} friends!", "hello", 42) == "Well, hello my 42 friends!";
|
||||
```
|
||||
|
||||
If you want to include a literal `{` in the output, use `{{`:
|
||||
|
||||
```c++
|
||||
DeprecatedString::formatted("{{ {}", "hello") == "{ hello";
|
||||
ByteString::formatted("{{ {}", "hello") == "{ hello";
|
||||
```
|
||||
|
||||
You can refer to the arguments by index, if you want to repeat one or change the order:
|
||||
|
||||
```c++
|
||||
DeprecatedString::formatted("{2}{0}{1}", "a", "b", "c") == "cab";
|
||||
ByteString::formatted("{2}{0}{1}", "a", "b", "c") == "cab";
|
||||
```
|
||||
|
||||
To control how the arguments are formatted, add colon after the optional index, and then add format specifier
|
||||
characters:
|
||||
|
||||
```c++
|
||||
DeprecatedString::formatted("{:.4}", "cool dude") == "cool";
|
||||
DeprecatedString::formatted("{0:.4}", "cool dude") == "cool";
|
||||
ByteString::formatted("{:.4}", "cool dude") == "cool";
|
||||
ByteString::formatted("{0:.4}", "cool dude") == "cool";
|
||||
```
|
||||
|
||||
## Format specifiers
|
||||
|
@ -135,6 +135,6 @@ type cannot be formatted. For example:
|
|||
|
||||
```c++
|
||||
// B has a Formatter defined, but A does not.
|
||||
DeprecatedString::formatted("{}", FormatIfSupported { A {} }) == "?";
|
||||
DeprecatedString::formatted("{}", FormatIfSupported { B {} }) == "B";
|
||||
ByteString::formatted("{}", FormatIfSupported { A {} }) == "?";
|
||||
ByteString::formatted("{}", FormatIfSupported { B {} }) == "B";
|
||||
```
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue