OpenTTD Source 20241224-master-gf74b0cf984
|
Handling of C-type strings (char*). More...
#include "stdafx.h"
#include "debug.h"
#include "core/alloc_func.hpp"
#include "core/math_func.hpp"
#include "error_func.h"
#include "string_func.h"
#include "string_base.h"
#include "table/control_codes.h"
#include <sstream>
#include <iomanip>
#include <unicode/ustring.h>
#include "language.h"
#include "gfx_func.h"
#include "safeguards.h"
#include <unicode/stsearch.h>
#include <unicode/utext.h>
#include <unicode/brkiter.h>
Go to the source code of this file.
Data Structures | |
struct | CaseInsensitiveCharTraits |
Case insensitive implementation of the standard character type traits. More... | |
class | IcuStringIterator |
String iterator using ICU as a backend. More... | |
Typedefs | |
typedef std::basic_string_view< char, CaseInsensitiveCharTraits > | CaseInsensitiveStringView |
Case insensitive string view. | |
Functions | |
void | strecpy (std::span< char > dst, std::string_view src) |
Copies characters from one buffer to another. | |
std::string | FormatArrayAsHex (std::span< const uint8_t > data) |
Format a byte array into a continuous hex string. | |
template<class T > | |
static void | StrMakeValid (T &dst, const char *str, const char *last, StringValidationSettings settings) |
Copies the valid (UTF-8) characters from str up to last to the dst . | |
void | StrMakeValidInPlace (char *str, const char *last, StringValidationSettings settings) |
Scans the string for invalid characters and replaces then with a question mark '?' (if not ignored). | |
void | StrMakeValidInPlace (char *str, StringValidationSettings settings) |
Scans the string for invalid characters and replaces then with a question mark '?' (if not ignored). | |
std::string | StrMakeValid (std::string_view str, StringValidationSettings settings) |
Copies the valid (UTF-8) characters from str to the returned string. | |
bool | StrValid (std::span< const char > str) |
Checks whether the given string is valid, i.e. | |
void | StrTrimInPlace (std::string &str) |
Trim the spaces from given string in place, i.e. | |
std::string_view | StrTrimView (std::string_view str) |
bool | StrStartsWithIgnoreCase (std::string_view str, const std::string_view prefix) |
Check whether the given string starts with the given prefix, ignoring case. | |
bool | StrEndsWithIgnoreCase (std::string_view str, const std::string_view suffix) |
Check whether the given string ends with the given suffix, ignoring case. | |
int | StrCompareIgnoreCase (const std::string_view str1, const std::string_view str2) |
Compares two string( view)s, while ignoring the case of the characters. | |
bool | StrEqualsIgnoreCase (const std::string_view str1, const std::string_view str2) |
Compares two string( view)s for equality, while ignoring the case of the characters. | |
size_t | Utf8StringLength (const char *s) |
Get the length of an UTF-8 encoded string in number of characters and thus not the number of bytes that the encoded string contains. | |
size_t | Utf8StringLength (const std::string &str) |
Get the length of an UTF-8 encoded string in number of characters and thus not the number of bytes that the encoded string contains. | |
bool | strtolower (std::string &str, std::string::size_type offs) |
bool | IsValidChar (char32_t key, CharSetFilter afilter) |
Only allow certain keys. | |
size_t | Utf8Decode (char32_t *c, const char *s) |
Decode and consume the next UTF-8 encoded character. | |
template<class T > | |
size_t | Utf8Encode (T buf, char32_t c) |
Encode a unicode character and place it in the buffer. | |
size_t | Utf8Encode (char *buf, char32_t c) |
size_t | Utf8Encode (std::ostreambuf_iterator< char > &buf, char32_t c) |
size_t | Utf8Encode (std::back_insert_iterator< std::string > &buf, char32_t c) |
size_t | Utf8TrimString (char *s, size_t maxlen) |
Properly terminate an UTF8 string to some maximum length. | |
static bool | IsGarbageCharacter (char32_t c) |
Test if a unicode character is considered garbage to be skipped. | |
static std::string_view | SkipGarbage (std::string_view str) |
Skip some of the 'garbage' in the string that we don't want to use to sort on. | |
int | StrNaturalCompare (std::string_view s1, std::string_view s2, bool ignore_garbage_at_front) |
Compares two strings using case insensitive natural sort. | |
static int | ICUStringContains (const std::string_view str, const std::string_view value, bool case_insensitive) |
Search if a string is contained in another string using the current locale. | |
bool | StrNaturalContains (const std::string_view str, const std::string_view value) |
Checks if a string is contained in another string with a locale-aware comparison that is case sensitive. | |
bool | StrNaturalContainsIgnoreCase (const std::string_view str, const std::string_view value) |
Checks if a string is contained in another string with a locale-aware comparison that is case insensitive. | |
static int | ConvertHexNibbleToByte (char c) |
Convert a single hex-nibble to a byte. | |
bool | ConvertHexToBytes (std::string_view hex, std::span< uint8_t > bytes) |
Convert a hex-string to a byte-array, while validating it was actually hex. | |
Handling of C-type strings (char*).
Definition in file string.cpp.
typedef std::basic_string_view<char, CaseInsensitiveCharTraits> CaseInsensitiveStringView |
Case insensitive string view.
Definition at line 313 of file string.cpp.
|
static |
Convert a single hex-nibble to a byte.
c | The hex-nibble to convert. |
Definition at line 715 of file string.cpp.
Referenced by ConvertHexToBytes().
bool ConvertHexToBytes | ( | std::string_view | hex, |
std::span< uint8_t > | bytes | ||
) |
Convert a hex-string to a byte-array, while validating it was actually hex.
hex | The hex-string to convert. |
bytes | The byte-array to write the result to. |
Definition at line 734 of file string.cpp.
References ConvertHexNibbleToByte().
Referenced by X25519AuthorizedKeyClientHandler::GetValidSecretKeyAndUpdatePublicKey(), GRFLoadConfig(), PickerLoadConfig(), and ValidateSignature().
std::string FormatArrayAsHex | ( | std::span< const uint8_t > | data | ) |
Format a byte array into a continuous hex string.
data | Array to format |
Definition at line 81 of file string.cpp.
Referenced by AddGrfInfo(), CalculateHashV1(), GenerateUid(), X25519AuthenticationHandler::GetPeerPublicKey(), X25519AuthorizedKeyClientHandler::GetValidSecretKeyAndUpdatePublicKey(), HandleSavegameLoadCrash(), IsGoodGRFConfigList(), CommandHelperBase::LogCommandExecution(), MakePNGImage(), NetworkContentListWindow::OpenExternalSearch(), OutputContentState(), ClientNetworkGameSocketHandler::Receive_SERVER_CHECK_NEWGRFS(), and SurveyGrfs().
|
static |
Search if a string is contained in another string using the current locale.
str | String to search in. |
value | String to search for. |
case_insensitive | Search case-insensitive. |
Definition at line 630 of file string.cpp.
References _current_collator.
Referenced by StrNaturalContains(), and StrNaturalContainsIgnoreCase().
|
static |
Test if a unicode character is considered garbage to be skipped.
c | Character to test. |
Definition at line 549 of file string.cpp.
Referenced by SkipGarbage().
bool IsValidChar | ( | char32_t | key, |
CharSetFilter | afilter | ||
) |
Only allow certain keys.
You can define the filter to be used. This makes sure no invalid keys can get into an editbox, like BELL.
key | character to be checked |
afilter | the filter to use |
Definition at line 396 of file string.cpp.
References CS_ALPHA, CS_ALPHANUMERAL, CS_HEXADECIMAL, CS_NUMERAL, CS_NUMERAL_SIGNED, and CS_NUMERAL_SPACE.
Referenced by IConsoleCmdExec(), Textbuf::InsertString(), OskWindow::OnClick(), VideoDriver_SDL_Base::PollEvent(), TranslateTTDPatchCodes(), and OskWindow::UpdateOskState().
|
static |
Skip some of the 'garbage' in the string that we don't want to use to sort on.
This way the alphabetical sorting will work better as we would be actually using those characters instead of some other characters such as spaces and tildes at the begin of the name.
str | The string to skip the initial garbage of. |
Definition at line 568 of file string.cpp.
References IsGarbageCharacter(), and Utf8Decode().
Referenced by StrNaturalCompare().
int StrCompareIgnoreCase | ( | const std::string_view | str1, |
const std::string_view | str2 | ||
) |
Compares two string( view)s, while ignoring the case of the characters.
str1 | The first string. |
str2 | The second string. |
Definition at line 334 of file string.cpp.
Referenced by GRFFileScanner::AddFile(), MatchesExtension(), StrEqualsIgnoreCase(), and StrNaturalCompare().
void strecpy | ( | std::span< char > | dst, |
std::string_view | src | ||
) |
Copies characters from one buffer to another.
Copies the source string to the destination buffer with respect of the terminating null-character and the size of the destination buffer.
dst | The destination buffer |
src | The buffer containing the string to copy |
Definition at line 60 of file string.cpp.
References Debug.
Referenced by FileStringReader::HandlePragma(), and StringReader::ParseFile().
bool StrEndsWithIgnoreCase | ( | std::string_view | str, |
const std::string_view | suffix | ||
) |
Check whether the given string ends with the given suffix, ignoring case.
str | The string to look at. |
suffix | The suffix to look for. |
Definition at line 321 of file string.cpp.
References StrEqualsIgnoreCase().
Referenced by TextfileWindow::AfterLoadText(), and TextfileWindow::NavigateToFile().
bool StrEqualsIgnoreCase | ( | const std::string_view | str1, |
const std::string_view | str2 | ||
) |
Compares two string( view)s for equality, while ignoring the case of the characters.
str1 | The first string. |
str2 | The second string. |
Definition at line 347 of file string.cpp.
References StrCompareIgnoreCase().
Referenced by ChangeWorkingDirectoryToExecutable(), DEF_CONSOLE_CMD(), AIScannerInfo::FindInfo(), GameScannerInfo::FindInfo(), FindKey(), FiosGetSavegameListCallback(), FiosGetScenarioListCallback(), FiosGetTownDataListCallback(), FiosMakeFilename(), FiosNumberedSaveName::FiosNumberedSaveName(), BlitterFactory::GetBlitterFactory(), GetFontByFaceName(), IsSameScript(), ParseCode(), ScriptScanner::RegisterScript(), DriverFactoryBase::SelectDriverImpl(), StrEndsWithIgnoreCase(), StringToContentType(), and StrStartsWithIgnoreCase().
std::string StrMakeValid | ( | std::string_view | str, |
StringValidationSettings | settings | ||
) |
Copies the valid (UTF-8) characters from str
to the returned string.
Depending on the settings
invalid characters can be replaced with a question mark, as well as determining what characters are deemed invalid.
str | The string to validate. |
settings | The settings for the string validation. |
Definition at line 205 of file string.cpp.
References settings, and StrMakeValid().
|
static |
Copies the valid (UTF-8) characters from str
up to last
to the dst
.
Depending on the settings
invalid characters can be replaced with a question mark, as well as determining what characters are deemed invalid.
It is allowed for dst
to be the same as src
, in which case the string is make valid in place.
dst | The destination to write to. |
str | The string to validate. |
last | The last valid character of str. |
settings | The settings for the string validation. |
Definition at line 107 of file string.cpp.
References settings, SVS_ALLOW_CONTROL_CODE, SVS_ALLOW_NEWLINE, SVS_REPLACE_TAB_CR_NL_WITH_SPACE, SVS_REPLACE_WITH_QUESTION_MARK, Utf8Decode(), and Utf8EncodedCharLen().
Referenced by FiosFileScanner::AddFile(), ScriptInfo::AddLabels(), ScriptInfo::AddSetting(), DrawNewsString(), ErrorUnknownCallbackResult(), ExtractString(), GetFileTitle(), GetMusicCatEntryName(), GlobalVarChangeInfo(), IConsolePrint(), IniGroup::IniGroup(), IniItem::IniItem(), IniLoadFile::LoadFromDisk(), LoadFromHighScore(), LoadNewGRFSound(), ScriptInstance::LoadObjects(), TextfileWindow::LoadText(), StringSettingDesc::MakeValueValid(), ReadDWordAsString(), Packet::Recv_string(), SanitizeSingleStringHelper(), ShowNewGrfVehicleError(), SlStdString(), StrMakeValid(), and StrMakeValidInPlace().
void StrMakeValidInPlace | ( | char * | str, |
const char * | last, | ||
StringValidationSettings | settings | ||
) |
Scans the string for invalid characters and replaces then with a question mark '?' (if not ignored).
str | The string to validate. |
last | The last valid character of str. |
settings | The settings for the string validation. |
Definition at line 178 of file string.cpp.
References settings, and StrMakeValid().
Referenced by Textbuf::Assign(), and StrMakeValidInPlace().
void StrMakeValidInPlace | ( | char * | str, |
StringValidationSettings | settings | ||
) |
Scans the string for invalid characters and replaces then with a question mark '?' (if not ignored).
Only use this function when you are sure the string ends with a '\0'; otherwise use StrMakeValidInPlace(str, last, settings) variant.
str | The string (of which you are sure ends with '\0') to validate. |
Definition at line 192 of file string.cpp.
References settings, and StrMakeValidInPlace().
int StrNaturalCompare | ( | std::string_view | s1, |
std::string_view | s2, | ||
bool | ignore_garbage_at_front | ||
) |
Compares two strings using case insensitive natural sort.
s1 | First string to compare. |
s2 | Second string to compare. |
ignore_garbage_at_front | Skip punctuation characters in the front |
Definition at line 589 of file string.cpp.
References _current_collator, MacOSStringCompare(), SkipGarbage(), and StrCompareIgnoreCase().
Referenced by BuildGuiGroupList(), CargoSpecNameSorter(), EngineNameSorter(), GRFSorter(), IndustryDirectoryWindow::IndustryNameSorter(), IndustryTypeNameSorter(), NetworkContentListWindow::NameSorter(), NewGRFWindow::NameSorter(), DropDownString< TBase, TFs, TEnd >::NatSortFunc(), NetworkGameWindow::NGameNameSorter(), FiosItem::operator<(), SignList::SignNameSorter(), CompanyStationsWindow::StationNameSorter(), TownDirectoryWindow::TownNameSorter(), NetworkContentListWindow::TypeSorter(), and VehicleNameSorter().
bool StrNaturalContains | ( | const std::string_view | str, |
const std::string_view | value | ||
) |
Checks if a string is contained in another string with a locale-aware comparison that is case sensitive.
str | The string to search in. |
value | The string to search for. |
Definition at line 660 of file string.cpp.
References ICUStringContains(), MacOSStringContains(), and Win32StringContains().
Referenced by StringFilter::AddLine().
bool StrNaturalContainsIgnoreCase | ( | const std::string_view | str, |
const std::string_view | value | ||
) |
Checks if a string is contained in another string with a locale-aware comparison that is case insensitive.
str | The string to search in. |
value | The string to search for. |
Definition at line 687 of file string.cpp.
References ICUStringContains(), MacOSStringContains(), and Win32StringContains().
Referenced by StringFilter::AddLine().
bool StrStartsWithIgnoreCase | ( | std::string_view | str, |
const std::string_view | prefix | ||
) |
Check whether the given string starts with the given prefix, ignoring case.
str | The string to look at. |
prefix | The prefix to look for. |
Definition at line 281 of file string.cpp.
References StrEqualsIgnoreCase().
bool strtolower | ( | std::string & | str, |
std::string::size_type | offs | ||
) |
Definition at line 378 of file string.cpp.
void StrTrimInPlace | ( | std::string & | str | ) |
Trim the spaces from given string in place, i.e.
the string buffer that is passed will be modified whenever spaces exist in the given string. When there are spaces at the begin, the whole string is moved forward and when there are spaces at the back the '\0' termination is moved.
str | The string to perform the in place trimming on. |
Definition at line 260 of file string.cpp.
Referenced by TarScanner::AddFile(), CheckClientAndServerName(), NetworkValidateClientName(), and NetworkValidateServerName().
std::string_view StrTrimView | ( | std::string_view | str | ) |
Definition at line 265 of file string.cpp.
bool StrValid | ( | std::span< const char > | str | ) |
Checks whether the given string is valid, i.e.
contains only valid (printable) characters and is properly terminated.
str | Span of chars to validate. |
Definition at line 227 of file string.cpp.
References Utf8Decode(), and Utf8EncodedCharLen().
Referenced by LanguagePackHeader::IsValid().
size_t Utf8Decode | ( | char32_t * | c, |
const char * | s | ||
) |
Decode and consume the next UTF-8 encoded character.
c | Buffer to place decoded character. |
s | Character stream to retrieve character from. |
Definition at line 419 of file string.cpp.
References GB(), and HasBit().
Referenced by Textbuf::DeleteChar(), FixSCCEncoded(), FormatString(), GlobalVarChangeInfo(), VideoDriver_SDL_Base::PollEvent(), StringFilter::SetFilterTerm(), SkipGarbage(), StrMakeValid(), StrValid(), and TranslateTTDPatchCodes().
size_t Utf8Encode | ( | char * | buf, |
char32_t | c | ||
) |
Definition at line 486 of file string.cpp.
size_t Utf8Encode | ( | std::back_insert_iterator< std::string > & | buf, |
char32_t | c | ||
) |
Definition at line 496 of file string.cpp.
size_t Utf8Encode | ( | std::ostreambuf_iterator< char > & | buf, |
char32_t | c | ||
) |
Definition at line 491 of file string.cpp.
|
inline |
Encode a unicode character and place it in the buffer.
T | Type of the buffer. |
buf | Buffer to place character. |
c | Unicode character to encode. |
Definition at line 460 of file string.cpp.
References GB().
Referenced by CheckForMissingGlyphs(), CopyFromOldName(), TextfileWindow::FindHyperlinksInMarkdown(), FixSCCEncoded(), UnmappedChoiceList::Flush(), FormatString(), Textbuf::InsertChar(), and TranslateTTDPatchCodes().
size_t Utf8StringLength | ( | const char * | s | ) |
Get the length of an UTF-8 encoded string in number of characters and thus not the number of bytes that the encoded string contains.
s | The string to get the length for. |
Definition at line 359 of file string.cpp.
Referenced by Textbuf::Assign(), CmdAlterGroup(), CmdFoundTown(), CmdPlaceSign(), CmdRenameCompany(), CmdRenameDepot(), CmdRenameEngine(), CmdRenamePresident(), CmdRenameSign(), CmdRenameStation(), CmdRenameTown(), CmdRenameVehicle(), CmdRenameWaypoint(), GenerateCompanyName(), GeneratePresidentName(), Utf8StringLength(), and VerifyTownName().
size_t Utf8StringLength | ( | const std::string & | str | ) |
Get the length of an UTF-8 encoded string in number of characters and thus not the number of bytes that the encoded string contains.
s | The string to get the length for. |
Definition at line 373 of file string.cpp.
References Utf8StringLength().
size_t Utf8TrimString | ( | char * | s, |
size_t | maxlen | ||
) |
Properly terminate an UTF8 string to some maximum length.
s | string to check if it needs additional trimming |
maxlen | the maximum length the buffer can have. |
Definition at line 508 of file string.cpp.
References Utf8EncodedCharLen().