Translate continues.

Author: orefkov

bench/process_result.cpp

@@ -13,8 +13,10 @@ using results_vector = std::vector<result_info>;
 
 bool extract_cpu_info(ssa text, ssa& res) {
     // Найдём, где начинается "Run on ", потом где за ним начинается "\n---"
+    // Find where "Run on" begins, then where after it "\n---" begins
     size_t start = text.find("Run on "), end = text.find("\n---", start);
     // Если что-то не нашлось - ошибка
+    // If something was not found - an error
     if (start == str::npos || end == str::npos) {
         return false;
     }
@@ -34,6 +36,7 @@ struct result_info {
             throw std::runtime_error{"Not found cpu info"};
         }
         // Текущее положение поставим сразу за cpuinfo и откинем завершающие переводы строк
+        // We will put the current position immediately after cpuinfo and discard the final line feeds
         current_text_ = current_text_(cpu_info_.end() - current_text_.begin() + 1).trimmed_right("\n");
     }
 };
@@ -57,14 +60,16 @@ stringa get_file_content(stra filePath) {
     std::streamsize size = file.tellg();
     file.seekg(0, std::ios::beg);
     // Такой тип удобен для передачи потом в stringa
+    // This type is convenient for later passing to stringa
     lstringsa<0> result;
     file.read(result.set_size(size), size);
     result.replace("\r\n", "\n");
-    return result;
+    return std::move(result);
 }
 
 results_vector get_results_infos() {
     // Отберём в директории results все файлы с названиями, заканчивающимися на ".txt" и отсортируем их по имени
+    // Select all files in the results directory with names ending in ".txt" and sort them by name
     const ssa suffix = ".txt", dirForResults = "results/";
     std::vector<stringa> fileNames;
     for (const auto& f: std::filesystem::directory_iterator{str_to_path(dirForResults)}) {
@@ -88,6 +93,7 @@ results_vector get_results_infos() {
         for (const auto& f : fileNames) {
             ssa fileName = f;
             // В начале имени файла может идти число и дефис, для сортировки, уберём их
+            // At the beginning of the file name there can be a number and a hyphen, for sorting, remove them
             if (auto delimeter = fileName.find('-'); delimeter != str::npos && delimeter > 0) {
                 if (std::get<1>(fileName(0, delimeter).to_int<unsigned, false, 10, false, false>()) == IntConvertResult::Success) {
                     fileName.remove_prefix(delimeter + 1);
@@ -188,6 +194,7 @@ ssa extract_source_for_benchmark(ssa benchName, ssa sourceText) {
     auto [it, not_exist] = textes.try_emplace(benchName);
     if (not_exist) {
         // Ищем имя функции для этого бенчмарка
+        // Looking for the name of the function for this benchmark
         size_t start = sourceText.find(lstringa<128>{"->Name(\"" + e_repl(benchName, "\"", "\\\"") + "\")"});
         if (start == str::npos) {
             std::cerr << "Can not found benchmark function name for " << benchName << std::endl;
@@ -204,6 +211,7 @@ ssa extract_source_for_benchmark(ssa benchName, ssa sourceText) {
         auto [func_it, not_exist] = textes.try_emplace(funcName);
         if (not_exist) {
             // Теперь ищем саму эту функцию
+            // Now we look for this function itself
             start = sourceText.find(lstringa<128>{funcName + "(benchmark::State"});
             if (start == str::npos) {
                 std::cerr << "Can not found source function " << funcName << " for benchmark " << benchName << std::endl;
@@ -218,6 +226,7 @@ ssa extract_source_for_benchmark(ssa benchName, ssa sourceText) {
             }
             size_t end = -1;
             // Проверим, возможно там есть переход на другую функцию через //>
+            // Let's check, maybe there is a transition to another function via //>
             ssa prevLine = sourceText.from_to(sourceText.find_last('\n', start - 1) + 1, start);
             if (prevLine.starts_with("//> ")) {
                 prevLine.remove_prefix(4);
@@ -262,6 +271,7 @@ void write_benchmarks(out_t& out, const results_vector& results, ssa sourceText,
             auto source = extract_source_for_benchmark(benchName, sourceText);
             auto comment = extract_comment(commentsText, benchName);
             // Нужно вывести название бенча и коммент
+            // Need to display title and comment
             out += "\n<tr><td class=\"benchmarkname\"><span class=\"tooltip\">" +
                 repl_html_symbols(benchName) +
                 "<span class=\"tooltiptext code\">" +
@@ -296,18 +306,21 @@ void write_benchmarks(out_t& out, const results_vector& results, ssa sourceText,
             continue;
         } else if (line.starts_with("--") && !line.ends_with("---")) {
             // Начинается новый набор бенчмарков
+            // Starts a new set of benchmarks
             if (needFooter) {
                 write_benchset_footer(out, script_text);
             }
             benchName = extract_name_result(line, result);
             // Из названия набора надо удалить начальные и конечные ---
+            // From the name of the set we need to remove the beginning and end ---
             benchName = benchName.from_to(benchName.find(' ') + 1, benchName.find_last(' ')).trimmed();
             write_benchset_header(out, results, benchName, ++benchSetId);
             needFooter = true;
             needCommaForTests = false;
             script_text = "bench_sets['" + e_repl(benchName.to_str(), "'", "\\'") + "'] = {id:'bs" + benchSetId +"', tests:[";
         }
         // Эти строки надо пропустить во всех файлах
+        // These lines must be skipped in all files
         for (unsigned idx = 1; idx < results.size(); idx++) {
             if (splitters[idx].is_done()) {
                 std::cerr << "Not expected end of file for " << results[idx].platform_ << std::endl;

include/simstr/sstring.h

@@ -4618,8 +4618,8 @@ struct expr_num {
 };
 
 /*!
- * @brief Оператор конкатенации для строкового выражения и целого числа.
  * @ingroup StrExprs
+ * @brief Оператор конкатенации для строкового выражения и целого числа.
  * @param a - строковое выражение
  * @param s - число
  * @details Число конвертируется в десятичное строковое представление.
@@ -4630,8 +4630,8 @@ inline constexpr auto operator + (const A& a, T s) {
 }
 
 /*!
- * @brief Оператор конкатенации для целого числа и строкового выражения.
  * @ingroup StrExprs
+ * @brief Оператор конкатенации для целого числа и строкового выражения.
  * @param s - число
  * @param a - строковое выражение
  * @details Число конвертируется в десятичное строковое представление.
@@ -4642,8 +4642,8 @@ inline constexpr auto operator + (T s, const A& a) {
 }
 
 /*!
- * @brief Преобразование целого числа в строковое выражение
  * @ingroup StrExprs
+ * @brief Преобразование целого числа в строковое выражение
  * @tparam K - тип символов
  * @tparam T - тип числа, выводится из аргумента
  * @param t - число
@@ -4690,8 +4690,8 @@ struct expr_real {
 };
 
 /*!
- * @brief Оператор конкатенации для строкового выражения и вещественного числа (`float`, `double`).
  * @ingroup StrExprs
+ * @brief Оператор конкатенации для строкового выражения и вещественного числа (`float`, `double`).
  * @param a - строковое выражение
  * @param s - число
  * @details Число конвертируется в строковое представление через sprintf("%.16g").
@@ -4703,8 +4703,8 @@ inline constexpr auto operator+(const A& a, R s) {
 }
 
 /*!
- * @brief Оператор конкатенации для вещественного числа (`float`, `double`) и строкового выражения.
  * @ingroup StrExprs
+ * @brief Оператор конкатенации для вещественного числа (`float`, `double`) и строкового выражения.
  * @param s - число
  * @param a - строковое выражение
  * @details Число конвертируется в строковое представление через `sprintf("%.16g")`.
@@ -4716,8 +4716,8 @@ inline constexpr auto operator+(R s, const A& a) {
 }
 
 /*!
- * @brief Преобразование `double` числа в строковое выражение
  * @ingroup StrExprs
+ * @brief Преобразование `double` числа в строковое выражение
  * @param t - число
  * @details Возвращает строковое выражение, которое генерирует десятичное представление заданного числа
  * с помощью `sprintf("%.16g")`. Может использоваться, когда надо конкатенировть число и строковый литерал
@@ -4780,8 +4780,8 @@ struct expr_join {
 };
 
 /*!
- * @brief Получить строковое выражение, конкатенирующее строки в контейнере в одну строку с заданным разделителем
  * @ingroup StrExprs
+ * @brief Получить строковое выражение, конкатенирующее строки в контейнере в одну строку с заданным разделителем
  * @tparam tail - добавлять ли разделитель после последней строки
  * @tparam skip_empty - пропускать пустые строки без добавления разделителя
  * @param s - контейнер со строками, должен поддерживать `range for`.
@@ -4863,8 +4863,8 @@ struct expr_replaces {
 };
 
 /*!
- * @brief Получить строковое выражение, генерирующее строку с заменой всех вхождений заданной подстроки
  * @ingroup StrExprs
+ * @brief Получить строковое выражение, генерирующее строку с заменой всех вхождений заданной подстроки
  * @tparam K - тип символа, выводится из первого аргумента
  * @param w - начальная строка
  * @param p - строковый литерал, искомая подстрока
@@ -4877,8 +4877,8 @@ inline constexpr auto e_repl(simple_str<K> w, T&& p, X&& r) {
 }
 
 /*!
- * @brief Строковое выражение, генерирующее строку с заменой всех вхождений заданной подстроки.
  * @ingroup StrExprs
+ * @brief Строковое выражение, генерирующее строку с заменой всех вхождений заданной подстроки.
  * @tparam K - тип строкиs
  * @details `e_repl` позволяет заменять только с использование строковых литералов.
  *  В случае, когда искомая подстрока или строка замены не известны при компиляции, и задаются в runtime,
@@ -4972,8 +4972,8 @@ template<>
 struct replace_search_result_store<true> : std::vector<std::pair<size_t, size_t>> {};
 
 /*!
- * @brief Тип для строкового выражения, генерирующее строку, в которой заданные символы заменяются на заданные строки.
  * @ingroup StrExprs
+ * @brief Тип для строкового выражения, генерирующее строку, в которой заданные символы заменяются на заданные строки.
  * @tparam K - тип символа
  * @tparam UseVectorForReplace - использовать вектор для запоминания результатов поиска вхождений символов
  * @details Этот тип применяется, когда состав символов или соответствующих им замен не известен в compile time,
@@ -5359,9 +5359,9 @@ struct expr_replace_const_symbols {
 };
 
 /*!
+ * @ingroup StrExprs
  * @brief Возвращает строковое выражение, генерирующее строку, в которой заданные символы
  * заменены на заданные подстроки.
- * @ingroup StrExprs
  * @tparam UseVector - использовать вектор для сохранения результатов поиска символов.
  *      Более подробно описано в `expr_replace_symbols`.
  * @param src - исходная строка