OpenTTD
|
Handling of C-type strings (char*). More...
#include "stdafx.h"
#include "debug.h"
#include "core/alloc_func.hpp"
#include "core/math_func.hpp"
#include "string_func.h"
#include "string_base.h"
#include "table/control_codes.h"
#include <stdarg.h>
#include <ctype.h>
#include <unicode/ustring.h>
#include "language.h"
#include "gfx_func.h"
#include "safeguards.h"
#include <unicode/utext.h>
#include <unicode/brkiter.h>
Go to the source code of this file.
Data Structures | |
class | IcuStringIterator |
String iterator using ICU as a backend. More... |
Functions | |
int CDECL | vseprintf (char *str, const char *last, const char *format, va_list ap) |
Safer implementation of vsnprintf; same as vsnprintf except: | |
char * | strecat (char *dst, const char *src, const char *last) |
Appends characters from one string to another. | |
char * | strecpy (char *dst, const char *src, const char *last) |
Copies characters from one buffer to another. | |
char * | stredup (const char *s, const char *last) |
Create a duplicate of the given string. | |
char *CDECL | str_fmt (const char *str,...) |
Format, "printf", into a newly allocated string. | |
void | str_fix_scc_encoded (char *str, const char *last) |
Scan the string for old values of SCC_ENCODED and fix it to it's new, static value. | |
void | str_validate (char *str, const char *last, StringValidationSettings settings) |
Scans the string for valid characters and if it finds invalid ones, replaces them with a question mark '?' (if not ignored) | |
void | ValidateString (const char *str) |
Scans the string for valid characters and if it finds invalid ones, replaces them with a question mark '?'. | |
bool | StrValid (const char *str, const char *last) |
Checks whether the given string is valid, i.e. | |
void | str_strip_colours (char *str) |
Scans the string for colour codes and strips them. | |
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. | |
bool | strtolower (char *str) |
Convert a given ASCII string to lowercase. | |
bool | IsValidChar (WChar key, CharSetFilter afilter) |
Only allow certain keys. | |
int CDECL | seprintf (char *str, const char *last, const char *format,...) |
Safer implementation of snprintf; same as snprintf except: | |
char * | md5sumToString (char *buf, const char *last, const uint8 md5sum[16]) |
Convert the md5sum to a hexadecimal string representation. | |
size_t | Utf8Decode (WChar *c, const char *s) |
Decode and consume the next UTF-8 encoded character. | |
size_t | Utf8Encode (char *buf, WChar c) |
Encode a unicode character and place it in the buffer. | |
size_t | Utf8TrimString (char *s, size_t maxlen) |
Properly terminate an UTF8 string to some maximum length. | |
static const char * | SkipGarbage (const char *str) |
Skip some of the 'garbage' in the string that we don't want to use to sort on. | |
int | strnatcmp (const char *s1, const char *s2, bool ignore_garbage_at_front) |
Compares two strings using case insensitive natural sort. |
Handling of C-type strings (char*).
Definition in file string.cpp.
bool IsValidChar | ( | WChar | 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 338 of file string.cpp.
References CS_ALPHA, CS_ALPHANUMERAL, CS_HEXADECIMAL, CS_NUMERAL, and CS_NUMERAL_SPACE.
Referenced by IConsoleCmdExec(), Textbuf::InsertString(), OskWindow::OnClick(), TranslateTTDPatchCodes(), and OskWindow::UpdateOskState().
char* md5sumToString | ( | char * | buf, |
const char * | last, | ||
const uint8 | md5sum[16] | ||
) |
Convert the md5sum to a hexadecimal string representation.
buf | buffer to put the md5sum into |
last | last character of buffer (usually lastof(buf)) |
md5sum | the md5sum itself |
Definition at line 416 of file string.cpp.
References seprintf().
Referenced by HandleSavegameLoadCrash(), IsGoodGRFConfigList(), MakePNGImage(), NetworkContentListWindow::OpenExternalSearch(), OutputContentState(), PrintGrfInfo(), and ClientNetworkGameSocketHandler::Receive_SERVER_CHECK_NEWGRFS().
int CDECL seprintf | ( | char * | str, |
const char * | last, | ||
const char * | format, | ||
... | |||
) |
Safer implementation of snprintf; same as snprintf except:
str | buffer to write to up to last |
last | last character we may write to |
format | the formatting (see snprintf) |
Definition at line 398 of file string.cpp.
References vseprintf().
Referenced by _GenerateWorld(), ScriptInfo::AddLabels(), ScriptInfo::AddSetting(), AppendPathSeparator(), NetworkChatWindow::ChatTabCompletion(), CheckExternalFiles(), ScriptInfo::CheckMethod(), CloneVehicleName(), CmdRenamePresident(), Squirrel::CompileError(), Squirrel::CreateClassInstanceVM(), debug_print(), DeleteGRFPresetFromConfig(), DetermineBasePaths(), DeterminePaths(), CrashLogOSX::DisplayCrashDialog(), DoAutosave(), DoLoad(), DoScanWorkingDirectory(), ClientNetworkContentSocketHandler::DownloadSelectedContentHTTP(), NetworkContentListWindow::DrawDetails(), AIInfo::DummyConstructor(), CrashLog::FillCrashLog(), GameScannerInfo::FindInfo(), AIScannerInfo::FindInfo(), FileList::FindItem(), GameScannerLibrary::FindLibrary(), AIScannerLibrary::FindLibrary(), FiosBrowseTo(), FiosGetFileList(), FiosMakeFilename(), FormatBytes(), FormatNumber(), FormatString(), CrashLog::GamelogFillCrashLog(), GamelogPrint(), GenerateCompanyPasswordHash(), NetworkAddress::GetAddressAsString(), BlitterFactory::GetBlittersInfo(), ServerNetworkGameSocketHandler::GetClientName(), ScriptScanner::GetConsoleList(), GetDebugString(), DriverFactoryBase::GetDriversInfo(), GetLanguageList(), GameScannerInfo::GetScriptName(), AIScannerInfo::GetScriptName(), GameScannerLibrary::GetScriptName(), AIScannerLibrary::GetScriptName(), BaseMedia< Tbase_set >::GetSetsList(), GetTextfile(), GRFBuildParamList(), HandleSavegameLoadCrash(), IConsoleGetSetting(), IConsoleListSettings(), IniSaveSettings(), ScriptInstance::LoadCompatibilityScripts(), LoadGRFPresetFromConfig(), CrashLog::LogCompiler(), CrashLog::LogConfiguration(), CrashLog::LogGamelog(), CrashLog::LogLibraries(), CrashLog::LogOpenTTDVersion(), MakeIntList(), MakeManyOfMany(), MakeOneOfMany(), MakePNGImage(), MakeScreenshotName(), md5sumToString(), NetworkFindName(), NetworkHTTPSocketHandler::NetworkHTTPSocketHandler(), NetworkGameWindow::OnClick(), LandInfoWindow::OnInit(), NetworkContentListWindow::OpenExternalSearch(), PrintGrfInfo(), ClientNetworkGameSocketHandler::Receive_SERVER_CHAT(), ClientNetworkUDPSocketHandler::Receive_SERVER_RESPONSE(), ScriptScanner::RegisterScript(), NetworkAddress::Resolve(), Squirrel::RunError(), SaveGRFPresetToConfig(), SaveVersionInConfig(), ScanPath(), Script_CreateDummy(), Script_CreateDummyInfo(), SetFallbackFont(), ScriptConfig::SettingsToString(), ShowErrorMessage(), ShowHelp(), StateGameLoop(), CrashLog::WriteCrashLog(), and CrashLog::WriteSavegame().
|
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 555 of file string.cpp.
References IsInsideMM().
Referenced by strnatcmp().
void str_fix_scc_encoded | ( | char * | str, |
const char * | last | ||
) |
Scan the string for old values of SCC_ENCODED and fix it to it's new, static value.
str | the string to scan |
last | the last valid character of str |
Definition at line 158 of file string.cpp.
References Utf8Decode(), Utf8Encode(), and Utf8EncodedCharLen().
Referenced by SlString().
char* CDECL str_fmt | ( | const char * | str, |
... | |||
) |
Format, "printf", into a newly allocated string.
str | The formatting string. |
Definition at line 139 of file string.cpp.
References lastof, and vseprintf().
Referenced by DEF_CONSOLE_CMD(), DeterminePaths(), and BaseSet< T, Tnum_files, Tsearch_in_tars >::FillSetDetails().
void str_validate | ( | char * | str, |
const char * | last, | ||
StringValidationSettings | settings | ||
) |
Scans the string for valid characters and if it finds invalid ones, replaces them 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 184 of file string.cpp.
References SVS_ALLOW_CONTROL_CODE, SVS_ALLOW_NEWLINE, SVS_REPLACE_WITH_QUESTION_MARK, Utf8Decode(), and Utf8EncodedCharLen().
Referenced by FiosFileScanner::AddFile(), FiosGetFileList(), GetFileTitle(), IConsolePrint(), IniGroup::IniGroup(), IniItem::IniItem(), IniLoadFile::LoadFromDisk(), LoadFromHighScore(), TextfileWindow::LoadTextfile(), Packet::Recv_string(), SlString(), and ValidateString().
char* strecat | ( | char * | dst, |
const char * | src, | ||
const char * | last | ||
) |
Appends characters from one string to another.
Appends the source string to the destination string with respect of the terminating null-character and and the last pointer to the last element in the destination buffer. If the last pointer is set to NULL no boundary check is performed.
dst | The buffer containing the target string |
src | The buffer containing the string to append |
last | The pointer to the last element of the destination buffer |
Definition at line 73 of file string.cpp.
References strecpy().
char* strecpy | ( | char * | dst, |
const char * | src, | ||
const char * | last | ||
) |
Copies characters from one buffer to another.
Copies the source string to the destination buffer with respect of the terminating null-character and the last pointer to the last element in the destination buffer. If the last pointer is set to NULL no boundary check is performed.
dst | The destination buffer |
src | The buffer containing the string to copy |
last | The pointer to the last element of the destination buffer |
Definition at line 101 of file string.cpp.
char* stredup | ( | const char * | s, |
const char * | last | ||
) |
Create a duplicate of the given string.
s | The string to duplicate. |
last | The last character that is safe to duplicate. If NULL, the whole string is duplicated. |
Definition at line 126 of file string.cpp.
References ttd_strnlen().
Referenced by ScriptScanner::AddFile(), TarScanner::AddFile(), ScriptInfo::AddLabels(), ScriptInfo::AddSetting(), Subsidy::AwardTo(), ScriptConfig::Change(), NetworkChatWindow::ChatTabCompletion(), CheckForMissingGlyphs(), CloneVehicleName(), CmdAlterGroup(), CmdCreateGoal(), CmdCreateStoryPage(), CmdCustomNewsItem(), CmdFoundTown(), CmdPlaceSign(), CmdRenameCompany(), CmdRenameDepot(), CmdRenameEngine(), CmdRenamePresident(), CmdRenameSign(), CmdRenameStation(), CmdRenameTown(), CmdRenameVehicle(), CmdRenameWaypoint(), CmdSetGoalProgress(), CmdSetGoalText(), CmdSetStoryPageTitle(), CmdTownSetText(), AIInfo::Constructor(), ScriptInfo::Constructor(), BaseConsist::CopyConsistPropertiesFrom(), CopyFromOldName(), CopyOutDParam(), CopyTempEngineData(), DetermineBasePaths(), DeterminePaths(), DisableStaticNewGRFInfluencingNonStaticNewGRFs(), DriverFactoryBase::DriverFactoryBase(), AIInfo::DummyConstructor(), ErrorMessageData::ErrorMessageData(), FileWriter::FileWriter(), BaseSet< T, Tnum_files, Tsearch_in_tars >::FillSetDetails(), FioOpenFile(), UnmappedChoiceList::Flush(), FormatString(), GamelogSetting(), GetFontByFaceName(), GetGRFPresetList(), IniLoadFile::GetGroup(), GRFConfig::GRFConfig(), GRFError::GRFError(), GRFFile::GRFFile(), IConsoleAliasRegister(), IConsoleCmdRegister(), IConsoleHistoryAdd(), IConsolePrint(), IniGroup::IniGroup(), IniItem::IniItem(), IniLoadSettingList(), IniLoadSettings(), IniSaveSettings(), IsGoodGRFConfigList(), LanguageStrings::LanguageStrings(), IniLoadFile::LoadFromDisk(), NetworkServerKickOrBanIP(), AfterNewGRFScan::OnNewGRFsScanned(), openttd_main(), ReadRawLanguageStrings(), ScriptScanner::RegisterScript(), ScriptConfig::ScriptConfig(), ErrorMessageData::SetDParamStr(), GameOptionsWindow::SetMediaSet(), AIConfig::SetSetting(), ScriptConfig::SetSetting(), SetSettingValue(), IniItem::SetValue(), SlError(), MusicDriver_ExtMidi::Start(), ScriptConfig::StringToSettings(), TranslateGRFStrings(), UpdateElement(), ScanProgressWindow::UpdateNewGRFScanStatus(), UpdateOSKOriginalText(), and StringNameWriter::WriteStringID().
int strnatcmp | ( | const char * | s1, |
const char * | 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 569 of file string.cpp.
References _current_collator, and SkipGarbage().
Referenced by CargoSpecNameSorter(), EngineNameSorter(), GRFSorter(), VehicleGroupWindow::GroupNameSorter(), IndustryDirectoryWindow::IndustryNameSorter(), IndustryTypeNameSorter(), NetworkContentListWindow::NameSorter(), NewGRFWindow::NameSorter(), DropDownListStringItem::NatSortFunc(), NetworkGameWindow::NGameNameSorter(), SignList::SignNameSorter(), CompanyStationsWindow::StationNameSorter(), TownDirectoryWindow::TownNameSorter(), NetworkContentListWindow::TypeSorter(), and VehicleNameSorter().
bool strtolower | ( | char * | str | ) |
Convert a given ASCII string to lowercase.
NOTE: only support ASCII characters, no UTF8 fancy. As currently the function is only used to lowercase data-filenames if they are not found, this is sufficient. If more, or general functionality is needed, look to r7271 where it was removed because it was broken when using certain locales: eg in Turkish the uppercase 'I' was converted to '?', so just revert to the old functionality
str | string to convert |
Definition at line 320 of file string.cpp.
Referenced by GameScannerInfo::FindInfo(), AIScannerInfo::FindInfo(), GameScannerLibrary::FindLibrary(), AIScannerLibrary::FindLibrary(), FioFindFullPath(), FioFOpenFile(), FioOpenFile(), ScriptScanner::RegisterScript(), and SimplifyFileName().
bool StrValid | ( | const char * | str, |
const char * | last | ||
) |
Checks whether the given string is valid, i.e.
contains only valid (printable) characters and is properly terminated.
str | The string to validate. |
last | The last character of the string, i.e. the string must be terminated here or earlier. |
Definition at line 247 of file string.cpp.
References Utf8Decode(), and Utf8EncodedCharLen().
Referenced by LanguagePackHeader::IsValid().
size_t Utf8Decode | ( | WChar * | 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 437 of file string.cpp.
References GB(), and HasBit().
Referenced by Textbuf::DeleteChar(), FormatString(), Layouter::GetCharPosition(), GlobalVarChangeInfo(), Layouter::Layouter(), StringFilter::SetFilterTerm(), str_fix_scc_encoded(), str_strip_colours(), str_validate(), StrValid(), and TranslateTTDPatchCodes().
size_t Utf8Encode | ( | char * | buf, |
WChar | c | ||
) |
Encode a unicode character and place it in the buffer.
buf | Buffer to place character. |
c | Unicode character to encode. |
Definition at line 477 of file string.cpp.
References GB().
Referenced by CheckForMissingGlyphs(), CopyFromOldName(), DrawNewsString(), UnmappedChoiceList::Flush(), FormatString(), Textbuf::InsertChar(), str_fix_scc_encoded(), 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 300 of file string.cpp.
Referenced by CmdAlterGroup(), CmdFoundTown(), CmdPlaceSign(), CmdRenameCompany(), CmdRenameDepot(), CmdRenameEngine(), CmdRenamePresident(), CmdRenameSign(), CmdRenameStation(), CmdRenameTown(), CmdRenameVehicle(), CmdRenameWaypoint(), GenerateCompanyName(), GeneratePresidentName(), and VerifyTownName().
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 511 of file string.cpp.
References Utf8EncodedCharLen().
Referenced by NetworkAddChatMessage().
void ValidateString | ( | const char * | str | ) |
Scans the string for valid characters and if it finds invalid ones, replaces them with a question mark '?'.
str | the string to validate |
Definition at line 233 of file string.cpp.
References str_validate().
Referenced by ScriptInfo::AddLabels(), ScriptInfo::AddSetting(), and DetermineBasePaths().
int CDECL vseprintf | ( | char * | str, |
const char * | last, | ||
const char * | format, | ||
va_list | ap | ||
) |
Safer implementation of vsnprintf; same as vsnprintf except:
str | buffer to write to up to last |
last | last character we may write to |
format | the formatting (see snprintf) |
ap | the list of arguments for the format |
Definition at line 50 of file string.cpp.
References min().
Referenced by CStrA::AddFormatL(), debug(), error(), Squirrel::ErrorPrintFunc(), grfmsg(), IConsolePrintF(), MidiSendCommand(), NetworkAddChatMessage(), Textbuf::Print(), Squirrel::PrintFunc(), seprintf(), ShowInfoF(), str_fmt(), and usererror().