/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying file Copyright.txt or https://cmake.org/licensing for details. */ #define _SCL_SECURE_NO_WARNINGS #include "cmStringCommand.h" #include "cmsys/RegularExpression.hxx" #include #include #include #include #include #include #include "cmAlgorithms.h" #include "cmCryptoHash.h" #include "cmGeneratorExpression.h" #include "cmMakefile.h" #include "cmMessageType.h" #include "cmRange.h" #include "cmStringReplaceHelper.h" #include "cmSystemTools.h" #include "cmTimestamp.h" #include "cmUuid.h" class cmExecutionStatus; bool cmStringCommand::InitialPass(std::vector const& args, cmExecutionStatus&) { if (args.empty()) { this->SetError("must be called with at least one argument."); return false; } const std::string& subCommand = args[0]; if (subCommand == "REGEX") { return this->HandleRegexCommand(args); } if (subCommand == "REPLACE") { return this->HandleReplaceCommand(args); } if (subCommand == "MD5" || subCommand == "SHA1" || subCommand == "SHA224" || subCommand == "SHA256" || subCommand == "SHA384" || subCommand == "SHA512" || subCommand == "SHA3_224" || subCommand == "SHA3_256" || subCommand == "SHA3_384" || subCommand == "SHA3_512") { return this->HandleHashCommand(args); } if (subCommand == "TOLOWER") { return this->HandleToUpperLowerCommand(args, false); } if (subCommand == "TOUPPER") { return this->HandleToUpperLowerCommand(args, true); } if (subCommand == "COMPARE") { return this->HandleCompareCommand(args); } if (subCommand == "ASCII") { return this->HandleAsciiCommand(args); } if (subCommand == "CONFIGURE") { return this->HandleConfigureCommand(args); } if (subCommand == "LENGTH") { return this->HandleLengthCommand(args); } if (subCommand == "APPEND") { return this->HandleAppendCommand(args); } if (subCommand == "PREPEND") { return this->HandlePrependCommand(args); } if (subCommand == "CONCAT") { return this->HandleConcatCommand(args); } if (subCommand == "JOIN") { return this->HandleJoinCommand(args); } if (subCommand == "SUBSTRING") { return this->HandleSubstringCommand(args); } if (subCommand == "STRIP") { return this->HandleStripCommand(args); } if (subCommand == "REPEAT") { return this->HandleRepeatCommand(args); } if (subCommand == "RANDOM") { return this->HandleRandomCommand(args); } if (subCommand == "FIND") { return this->HandleFindCommand(args); } if (subCommand == "TIMESTAMP") { return this->HandleTimestampCommand(args); } if (subCommand == "MAKE_C_IDENTIFIER") { return this->HandleMakeCIdentifierCommand(args); } if (subCommand == "GENEX_STRIP") { return this->HandleGenexStripCommand(args); } if (subCommand == "UUID") { return this->HandleUuidCommand(args); } std::string e = "does not recognize sub-command " + subCommand; this->SetError(e); return false; } bool cmStringCommand::HandleHashCommand(std::vector const& args) { #if defined(CMAKE_BUILD_WITH_CMAKE) if (args.size() != 3) { std::ostringstream e; e << args[0] << " requires an output variable and an input string"; this->SetError(e.str()); return false; } std::unique_ptr hash(cmCryptoHash::New(args[0].c_str())); if (hash) { std::string out = hash->HashString(args[2]); this->Makefile->AddDefinition(args[1], out); return true; } return false; #else std::ostringstream e; e << args[0] << " not available during bootstrap"; this->SetError(e.str().c_str()); return false; #endif } bool cmStringCommand::HandleToUpperLowerCommand( std::vector const& args, bool toUpper) { if (args.size() < 3) { this->SetError("no output variable specified"); return false; } std::string const& outvar = args[2]; std::string output; if (toUpper) { output = cmSystemTools::UpperCase(args[1]); } else { output = cmSystemTools::LowerCase(args[1]); } // Store the output in the provided variable. this->Makefile->AddDefinition(outvar, output); return true; } bool cmStringCommand::HandleAsciiCommand(std::vector const& args) { if (args.size() < 3) { this->SetError("No output variable specified"); return false; } std::string::size_type cc; std::string const& outvar = args.back(); std::string output; for (cc = 1; cc < args.size() - 1; cc++) { int ch = atoi(args[cc].c_str()); if (ch > 0 && ch < 256) { output += static_cast(ch); } else { std::string error = "Character with code "; error += args[cc]; error += " does not exist."; this->SetError(error); return false; } } // Store the output in the provided variable. this->Makefile->AddDefinition(outvar, output); return true; } bool cmStringCommand::HandleConfigureCommand( std::vector const& args) { if (args.size() < 2) { this->SetError("No input string specified."); return false; } if (args.size() < 3) { this->SetError("No output variable specified."); return false; } // Parse options. bool escapeQuotes = false; bool atOnly = false; for (unsigned int i = 3; i < args.size(); ++i) { if (args[i] == "@ONLY") { atOnly = true; } else if (args[i] == "ESCAPE_QUOTES") { escapeQuotes = true; } else { std::ostringstream err; err << "Unrecognized argument \"" << args[i] << "\""; this->SetError(err.str()); return false; } } // Configure the string. std::string output; this->Makefile->ConfigureString(args[1], output, atOnly, escapeQuotes); // Store the output in the provided variable. this->Makefile->AddDefinition(args[2], output); return true; } bool cmStringCommand::HandleRegexCommand(std::vector const& args) { if (args.size() < 2) { this->SetError("sub-command REGEX requires a mode to be specified."); return false; } std::string const& mode = args[1]; if (mode == "MATCH") { if (args.size() < 5) { this->SetError("sub-command REGEX, mode MATCH needs " "at least 5 arguments total to command."); return false; } return this->RegexMatch(args); } if (mode == "MATCHALL") { if (args.size() < 5) { this->SetError("sub-command REGEX, mode MATCHALL needs " "at least 5 arguments total to command."); return false; } return this->RegexMatchAll(args); } if (mode == "REPLACE") { if (args.size() < 6) { this->SetError("sub-command REGEX, mode REPLACE needs " "at least 6 arguments total to command."); return false; } return this->RegexReplace(args); } std::string e = "sub-command REGEX does not recognize mode " + mode; this->SetError(e); return false; } bool cmStringCommand::RegexMatch(std::vector const& args) { //"STRING(REGEX MATCH // [...])\n"; std::string const& regex = args[2]; std::string const& outvar = args[3]; this->Makefile->ClearMatches(); // Compile the regular expression. cmsys::RegularExpression re; if (!re.compile(regex.c_str())) { std::string e = "sub-command REGEX, mode MATCH failed to compile regex \"" + regex + "\"."; this->SetError(e); return false; } // Concatenate all the last arguments together. std::string input = cmJoin(cmMakeRange(args).advance(4), std::string()); // Scan through the input for all matches. std::string output; if (re.find(input)) { this->Makefile->StoreMatches(re); std::string::size_type l = re.start(); std::string::size_type r = re.end(); if (r - l == 0) { std::string e = "sub-command REGEX, mode MATCH regex \"" + regex + "\" matched an empty string."; this->SetError(e); return false; } output = input.substr(l, r - l); } // Store the output in the provided variable. this->Makefile->AddDefinition(outvar, output); return true; } bool cmStringCommand::RegexMatchAll(std::vector const& args) { //"STRING(REGEX MATCHALL // [...])\n"; std::string const& regex = args[2]; std::string const& outvar = args[3]; this->Makefile->ClearMatches(); // Compile the regular expression. cmsys::RegularExpression re; if (!re.compile(regex.c_str())) { std::string e = "sub-command REGEX, mode MATCHALL failed to compile regex \"" + regex + "\"."; this->SetError(e); return false; } // Concatenate all the last arguments together. std::string input = cmJoin(cmMakeRange(args).advance(4), std::string()); // Scan through the input for all matches. std::string output; const char* p = input.c_str(); while (re.find(p)) { this->Makefile->ClearMatches(); this->Makefile->StoreMatches(re); std::string::size_type l = re.start(); std::string::size_type r = re.end(); if (r - l == 0) { std::string e = "sub-command REGEX, mode MATCHALL regex \"" + regex + "\" matched an empty string."; this->SetError(e); return false; } if (!output.empty()) { output += ";"; } output += std::string(p + l, r - l); p += r; } // Store the output in the provided variable. this->Makefile->AddDefinition(outvar, output); return true; } bool cmStringCommand::RegexReplace(std::vector const& args) { //"STRING(REGEX REPLACE // [...])\n" std::string const& regex = args[2]; std::string const& replace = args[3]; std::string const& outvar = args[4]; cmStringReplaceHelper replaceHelper(regex, replace, this->Makefile); if (!replaceHelper.IsReplaceExpressionValid()) { this->SetError( "sub-command REGEX, mode REPLACE: " + replaceHelper.GetError() + "."); return false; } this->Makefile->ClearMatches(); if (!replaceHelper.IsRegularExpressionValid()) { std::string e = "sub-command REGEX, mode REPLACE failed to compile regex \"" + regex + "\"."; this->SetError(e); return false; } // Concatenate all the last arguments together. const std::string input = cmJoin(cmMakeRange(args).advance(5), std::string()); std::string output; if (!replaceHelper.Replace(input, output)) { this->SetError( "sub-command REGEX, mode REPLACE: " + replaceHelper.GetError() + "."); return false; } // Store the output in the provided variable. this->Makefile->AddDefinition(outvar, output); return true; } bool cmStringCommand::HandleFindCommand(std::vector const& args) { // check if all required parameters were passed if (args.size() < 4 || args.size() > 5) { this->SetError("sub-command FIND requires 3 or 4 parameters."); return false; } // check if the reverse flag was set or not bool reverseMode = false; if (args.size() == 5 && args[4] == "REVERSE") { reverseMode = true; } // if we have 5 arguments the last one must be REVERSE if (args.size() == 5 && args[4] != "REVERSE") { this->SetError("sub-command FIND: unknown last parameter"); return false; } // local parameter names. const std::string& sstring = args[1]; const std::string& schar = args[2]; const std::string& outvar = args[3]; // ensure that the user cannot accidentally specify REVERSE as a variable if (outvar == "REVERSE") { this->SetError("sub-command FIND does not allow one to select REVERSE as " "the output variable. " "Maybe you missed the actual output variable?"); return false; } // try to find the character and return its position size_t pos; if (!reverseMode) { pos = sstring.find(schar); } else { pos = sstring.rfind(schar); } if (std::string::npos != pos) { std::ostringstream s; s << pos; this->Makefile->AddDefinition(outvar, s.str()); return true; } // the character was not found, but this is not really an error this->Makefile->AddDefinition(outvar, "-1"); return true; } bool cmStringCommand::HandleCompareCommand( std::vector const& args) { if (args.size() < 2) { this->SetError("sub-command COMPARE requires a mode to be specified."); return false; } std::string const& mode = args[1]; if ((mode == "EQUAL") || (mode == "NOTEQUAL") || (mode == "LESS") || (mode == "LESS_EQUAL") || (mode == "GREATER") || (mode == "GREATER_EQUAL")) { if (args.size() < 5) { std::string e = "sub-command COMPARE, mode "; e += mode; e += " needs at least 5 arguments total to command."; this->SetError(e); return false; } const std::string& left = args[2]; const std::string& right = args[3]; const std::string& outvar = args[4]; bool result; if (mode == "LESS") { result = (left < right); } else if (mode == "LESS_EQUAL") { result = (left <= right); } else if (mode == "GREATER") { result = (left > right); } else if (mode == "GREATER_EQUAL") { result = (left >= right); } else if (mode == "EQUAL") { result = (left == right); } else // if(mode == "NOTEQUAL") { result = !(left == right); } if (result) { this->Makefile->AddDefinition(outvar, "1"); } else { this->Makefile->AddDefinition(outvar, "0"); } return true; } std::string e = "sub-command COMPARE does not recognize mode " + mode; this->SetError(e); return false; } bool cmStringCommand::HandleReplaceCommand( std::vector const& args) { if (args.size() < 5) { this->SetError("sub-command REPLACE requires at least four arguments."); return false; } const std::string& matchExpression = args[1]; const std::string& replaceExpression = args[2]; const std::string& variableName = args[3]; std::string input = cmJoin(cmMakeRange(args).advance(4), std::string()); cmsys::SystemTools::ReplaceString(input, matchExpression.c_str(), replaceExpression.c_str()); this->Makefile->AddDefinition(variableName, input); return true; } bool cmStringCommand::HandleSubstringCommand( std::vector const& args) { if (args.size() != 5) { this->SetError("sub-command SUBSTRING requires four arguments."); return false; } const std::string& stringValue = args[1]; int begin = atoi(args[2].c_str()); int end = atoi(args[3].c_str()); const std::string& variableName = args[4]; size_t stringLength = stringValue.size(); int intStringLength = static_cast(stringLength); if (begin < 0 || begin > intStringLength) { std::ostringstream ostr; ostr << "begin index: " << begin << " is out of range 0 - " << stringLength; this->SetError(ostr.str()); return false; } if (end < -1) { std::ostringstream ostr; ostr << "end index: " << end << " should be -1 or greater"; this->SetError(ostr.str()); return false; } this->Makefile->AddDefinition(variableName, stringValue.substr(begin, end)); return true; } bool cmStringCommand::HandleLengthCommand(std::vector const& args) { if (args.size() != 3) { this->SetError("sub-command LENGTH requires two arguments."); return false; } const std::string& stringValue = args[1]; const std::string& variableName = args[2]; size_t length = stringValue.size(); char buffer[1024]; sprintf(buffer, "%d", static_cast(length)); this->Makefile->AddDefinition(variableName, buffer); return true; } bool cmStringCommand::HandleAppendCommand(std::vector const& args) { if (args.size() < 2) { this->SetError("sub-command APPEND requires at least one argument."); return false; } // Skip if nothing to append. if (args.size() < 3) { return true; } const std::string& variable = args[1]; std::string value; const char* oldValue = this->Makefile->GetDefinition(variable); if (oldValue) { value = oldValue; } value += cmJoin(cmMakeRange(args).advance(2), std::string()); this->Makefile->AddDefinition(variable, value); return true; } bool cmStringCommand::HandlePrependCommand( std::vector const& args) { if (args.size() < 2) { this->SetError("sub-command PREPEND requires at least one argument."); return false; } // Skip if nothing to prepend. if (args.size() < 3) { return true; } const std::string& variable = args[1]; std::string value = cmJoin(cmMakeRange(args).advance(2), std::string()); const char* oldValue = this->Makefile->GetDefinition(variable); if (oldValue) { value += oldValue; } this->Makefile->AddDefinition(variable, value); return true; } bool cmStringCommand::HandleConcatCommand(std::vector const& args) { if (args.size() < 2) { this->SetError("sub-command CONCAT requires at least one argument."); return false; } return this->joinImpl(args, std::string(), 1); } bool cmStringCommand::HandleJoinCommand(std::vector const& args) { if (args.size() < 3) { this->SetError("sub-command JOIN requires at least two arguments."); return false; } return this->joinImpl(args, args[1], 2); } bool cmStringCommand::joinImpl(std::vector const& args, std::string const& glue, const size_t varIdx) { std::string const& variableName = args[varIdx]; // NOTE Items to concat/join placed right after the variable for // both `CONCAT` and `JOIN` sub-commands. std::string value = cmJoin(cmMakeRange(args).advance(varIdx + 1), glue); this->Makefile->AddDefinition(variableName, value); return true; } bool cmStringCommand::HandleMakeCIdentifierCommand( std::vector const& args) { if (args.size() != 3) { this->SetError("sub-command MAKE_C_IDENTIFIER requires two arguments."); return false; } const std::string& input = args[1]; const std::string& variableName = args[2]; this->Makefile->AddDefinition(variableName, cmSystemTools::MakeCidentifier(input)); return true; } bool cmStringCommand::HandleGenexStripCommand( std::vector const& args) { if (args.size() != 3) { this->SetError("sub-command GENEX_STRIP requires two arguments."); return false; } const std::string& input = args[1]; std::string result = cmGeneratorExpression::Preprocess( input, cmGeneratorExpression::StripAllGeneratorExpressions); const std::string& variableName = args[2]; this->Makefile->AddDefinition(variableName, result); return true; } bool cmStringCommand::HandleStripCommand(std::vector const& args) { if (args.size() != 3) { this->SetError("sub-command STRIP requires two arguments."); return false; } const std::string& stringValue = args[1]; const std::string& variableName = args[2]; size_t inStringLength = stringValue.size(); size_t startPos = inStringLength + 1; size_t endPos = 0; const char* ptr = stringValue.c_str(); size_t cc; for (cc = 0; cc < inStringLength; ++cc) { if (!isspace(*ptr)) { if (startPos > inStringLength) { startPos = cc; } endPos = cc; } ++ptr; } size_t outLength = 0; // if the input string didn't contain any non-space characters, return // an empty string if (startPos > inStringLength) { outLength = 0; startPos = 0; } else { outLength = endPos - startPos + 1; } this->Makefile->AddDefinition(variableName, stringValue.substr(startPos, outLength)); return true; } bool cmStringCommand::HandleRepeatCommand(std::vector const& args) { // `string(REPEAT "" OUTPUT_VARIABLE)` enum ArgPos : std::size_t { SUB_COMMAND, VALUE, TIMES, OUTPUT_VARIABLE, TOTAL_ARGS }; if (args.size() != ArgPos::TOTAL_ARGS) { this->Makefile->IssueMessage( MessageType::FATAL_ERROR, "sub-command REPEAT requires three arguments."); return true; } unsigned long times; if (!cmSystemTools::StringToULong(args[ArgPos::TIMES].c_str(), ×)) { this->Makefile->IssueMessage(MessageType::FATAL_ERROR, "repeat count is not a positive number."); return true; } const auto& stringValue = args[ArgPos::VALUE]; const auto& variableName = args[ArgPos::OUTPUT_VARIABLE]; const auto inStringLength = stringValue.size(); std::string result; switch (inStringLength) { case 0u: // Nothing to do for zero length input strings break; case 1u: // NOTE If the string to repeat consists of the only character, // use the appropriate constructor. result = std::string(times, stringValue[0]); break; default: result = std::string(inStringLength * times, char{}); for (auto i = 0u; i < times; ++i) { std::copy(cm::cbegin(stringValue), cm::cend(stringValue), &result[i * inStringLength]); } break; } this->Makefile->AddDefinition(variableName, result); return true; } bool cmStringCommand::HandleRandomCommand(std::vector const& args) { if (args.size() < 2 || args.size() == 3 || args.size() == 5) { this->SetError("sub-command RANDOM requires at least one argument."); return false; } static bool seeded = false; bool force_seed = false; unsigned int seed = 0; int length = 5; const char cmStringCommandDefaultAlphabet[] = "qwertyuiopasdfghjklzxcvbnm" "QWERTYUIOPASDFGHJKLZXCVBNM" "0123456789"; std::string alphabet; if (args.size() > 3) { size_t i = 1; size_t stopAt = args.size() - 2; for (; i < stopAt; ++i) { if (args[i] == "LENGTH") { ++i; length = atoi(args[i].c_str()); } else if (args[i] == "ALPHABET") { ++i; alphabet = args[i]; } else if (args[i] == "RANDOM_SEED") { ++i; seed = static_cast(atoi(args[i].c_str())); force_seed = true; } } } if (alphabet.empty()) { alphabet = cmStringCommandDefaultAlphabet; } double sizeofAlphabet = static_cast(alphabet.size()); if (sizeofAlphabet < 1) { this->SetError("sub-command RANDOM invoked with bad alphabet."); return false; } if (length < 1) { this->SetError("sub-command RANDOM invoked with bad length."); return false; } const std::string& variableName = args.back(); std::vector result; if (!seeded || force_seed) { seeded = true; srand(force_seed ? seed : cmSystemTools::RandomSeed()); } const char* alphaPtr = alphabet.c_str(); for (int cc = 0; cc < length; cc++) { int idx = static_cast(sizeofAlphabet * rand() / (RAND_MAX + 1.0)); result.push_back(*(alphaPtr + idx)); } result.push_back(0); this->Makefile->AddDefinition(variableName, result.data()); return true; } bool cmStringCommand::HandleTimestampCommand( std::vector const& args) { if (args.size() < 2) { this->SetError("sub-command TIMESTAMP requires at least one argument."); return false; } if (args.size() > 4) { this->SetError("sub-command TIMESTAMP takes at most three arguments."); return false; } unsigned int argsIndex = 1; const std::string& outputVariable = args[argsIndex++]; std::string formatString; if (args.size() > argsIndex && args[argsIndex] != "UTC") { formatString = args[argsIndex++]; } bool utcFlag = false; if (args.size() > argsIndex) { if (args[argsIndex] == "UTC") { utcFlag = true; } else { std::string e = " TIMESTAMP sub-command does not recognize option " + args[argsIndex] + "."; this->SetError(e); return false; } } cmTimestamp timestamp; std::string result = timestamp.CurrentTime(formatString, utcFlag); this->Makefile->AddDefinition(outputVariable, result); return true; } bool cmStringCommand::HandleUuidCommand(std::vector const& args) { #if defined(CMAKE_BUILD_WITH_CMAKE) unsigned int argsIndex = 1; if (args.size() < 2) { this->SetError("UUID sub-command requires an output variable."); return false; } const std::string& outputVariable = args[argsIndex++]; std::string uuidNamespaceString; std::string uuidName; std::string uuidType; bool uuidUpperCase = false; while (args.size() > argsIndex) { if (args[argsIndex] == "NAMESPACE") { ++argsIndex; if (argsIndex >= args.size()) { this->SetError("UUID sub-command, NAMESPACE requires a value."); return false; } uuidNamespaceString = args[argsIndex++]; } else if (args[argsIndex] == "NAME") { ++argsIndex; if (argsIndex >= args.size()) { this->SetError("UUID sub-command, NAME requires a value."); return false; } uuidName = args[argsIndex++]; } else if (args[argsIndex] == "TYPE") { ++argsIndex; if (argsIndex >= args.size()) { this->SetError("UUID sub-command, TYPE requires a value."); return false; } uuidType = args[argsIndex++]; } else if (args[argsIndex] == "UPPER") { ++argsIndex; uuidUpperCase = true; } else { std::string e = "UUID sub-command does not recognize option " + args[argsIndex] + "."; this->SetError(e); return false; } } std::string uuid; cmUuid uuidGenerator; std::vector uuidNamespace; if (!uuidGenerator.StringToBinary(uuidNamespaceString, uuidNamespace)) { this->SetError("UUID sub-command, malformed NAMESPACE UUID."); return false; } if (uuidType == "MD5") { uuid = uuidGenerator.FromMd5(uuidNamespace, uuidName); } else if (uuidType == "SHA1") { uuid = uuidGenerator.FromSha1(uuidNamespace, uuidName); } else { std::string e = "UUID sub-command, unknown TYPE '" + uuidType + "'."; this->SetError(e); return false; } if (uuid.empty()) { this->SetError("UUID sub-command, generation failed."); return false; } if (uuidUpperCase) { uuid = cmSystemTools::UpperCase(uuid); } this->Makefile->AddDefinition(outputVariable, uuid); return true; #else std::ostringstream e; e << args[0] << " not available during bootstrap"; this->SetError(e.str().c_str()); return false; #endif }