LCOV - code coverage report
Current view: top level - EnergyPlus - StringUtilities.hh (source / functions) Coverage Total Hit
Test: lcov.output.filtered Lines: 88.7 % 53 47
Test Date: 2025-06-02 07:23:51 Functions: 77.3 % 22 17

            Line data    Source code
       1              : // EnergyPlus, Copyright (c) 1996-2025, The Board of Trustees of the University of Illinois,
       2              : // The Regents of the University of California, through Lawrence Berkeley National Laboratory
       3              : // (subject to receipt of any required approvals from the U.S. Dept. of Energy), Oak Ridge
       4              : // National Laboratory, managed by UT-Battelle, Alliance for Sustainable Energy, LLC, and other
       5              : // contributors. All rights reserved.
       6              : //
       7              : // NOTICE: This Software was developed under funding from the U.S. Department of Energy and the
       8              : // U.S. Government consequently retains certain rights. As such, the U.S. Government has been
       9              : // granted for itself and others acting on its behalf a paid-up, nonexclusive, irrevocable,
      10              : // worldwide license in the Software to reproduce, distribute copies to the public, prepare
      11              : // derivative works, and perform publicly and display publicly, and to permit others to do so.
      12              : //
      13              : // Redistribution and use in source and binary forms, with or without modification, are permitted
      14              : // provided that the following conditions are met:
      15              : //
      16              : // (1) Redistributions of source code must retain the above copyright notice, this list of
      17              : //     conditions and the following disclaimer.
      18              : //
      19              : // (2) Redistributions in binary form must reproduce the above copyright notice, this list of
      20              : //     conditions and the following disclaimer in the documentation and/or other materials
      21              : //     provided with the distribution.
      22              : //
      23              : // (3) Neither the name of the University of California, Lawrence Berkeley National Laboratory,
      24              : //     the University of Illinois, U.S. Dept. of Energy nor the names of its contributors may be
      25              : //     used to endorse or promote products derived from this software without specific prior
      26              : //     written permission.
      27              : //
      28              : // (4) Use of EnergyPlus(TM) Name. If Licensee (i) distributes the software in stand-alone form
      29              : //     without changes from the version obtained under this License, or (ii) Licensee makes a
      30              : //     reference solely to the software portion of its product, Licensee must refer to the
      31              : //     software as "EnergyPlus version X" software, where "X" is the version number Licensee
      32              : //     obtained under this License and may not use a different name for the software. Except as
      33              : //     specifically required in this Section (4), Licensee shall not use in a company name, a
      34              : //     product name, in advertising, publicity, or other promotional activities any name, trade
      35              : //     name, trademark, logo, or other designation of "EnergyPlus", "E+", "e+" or confusingly
      36              : //     similar designation, without the U.S. Department of Energy's prior written consent.
      37              : //
      38              : // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
      39              : // IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
      40              : // AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
      41              : // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
      42              : // CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      43              : // SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
      44              : // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
      45              : // OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
      46              : // POSSIBILITY OF SUCH DAMAGE.
      47              : 
      48              : #ifndef StringUtilities_hh_INCLUDED
      49              : #define StringUtilities_hh_INCLUDED
      50              : 
      51              : #include <EnergyPlus/FromChars.hh>
      52              : #include <ObjexxFCL/src/ObjexxFCL/Array1S.hh>
      53              : #include <fast_float/fast_float.h>
      54              : #include <sstream>
      55              : #include <type_traits>
      56              : 
      57              : namespace EnergyPlus {
      58          420 : inline std::stringstream stringReader(std::string_view str)
      59              : {
      60          420 :     std::stringstream result{str.data()};
      61              :     // result.imbue(std::locale("C"));
      62          420 :     return result;
      63              : }
      64              : 
      65              : template <class T, typename = std::enable_if_t<std::is_same_v<T, double> || std::is_same_v<T, int>>>
      66      7387342 : bool readListItem(std::string_view input, size_t &index, T &param)
      67              : {
      68      7387342 :     if (index >= input.size()) {
      69            0 :         return false;
      70              :     }
      71              : 
      72      7387342 :     input.remove_prefix(index);
      73              : 
      74      7387342 :     auto first_comma = input.find_first_not_of(',');
      75      7387342 :     if (first_comma != std::string_view::npos) {
      76      7387342 :         input.remove_prefix(first_comma);
      77              :     }
      78              : 
      79      7387342 :     auto first_char = input.find_first_not_of(' ');
      80      7387342 :     if (first_char != std::string_view::npos) {
      81      7387342 :         input.remove_prefix(first_char);
      82              :     }
      83              : 
      84      7387342 :     FromChars::from_chars_result result{};
      85              :     if constexpr (std::is_same_v<T, int>) {
      86      1420635 :         result = FromChars::from_chars(input.data(), input.data() + input.size(), param);
      87              :     } else if constexpr (std::is_same_v<T, double>) {
      88      5966707 :         auto fast_float_result = fast_float::from_chars(input.data(), input.data() + input.size(), param);
      89      5966707 :         result.ptr = fast_float_result.ptr;
      90      5966707 :         result.ec = fast_float_result.ec;
      91              :     }
      92      7387342 :     if (result.ec == std::errc::result_out_of_range || result.ec == std::errc::invalid_argument) {
      93            0 :         return false;
      94              :     }
      95      7387342 :     size_t pos = result.ptr - input.data();
      96      7387342 :     index += (pos + first_comma + first_char);
      97      7387342 :     return true;
      98              : }
      99              : 
     100          280 : template <typename Param> bool readListItem(std::istream &stream, Param &&param)
     101              : {
     102          280 :     if (stream.good()) {
     103          280 :         stream >> param;
     104          280 :         if (stream.good() && stream.peek() == ',') {
     105            0 :             stream.get(); // eat comma
     106              :         }
     107              :     } else {
     108              :         // the stream was not good, it was, perhaps EOF. So we need to
     109              :         // set the fail bit here to say that we ran out of string
     110              :         // and were unable to read the next bit of data
     111            0 :         stream.setstate(std::ios_base::failbit);
     112              :     }
     113              : 
     114          280 :     return !stream.fail();
     115              : }
     116              : 
     117           40 : template <typename Param> bool readItem(std::string_view input, Param &&param)
     118              : {
     119           40 :     auto stream = stringReader(input);
     120           40 :     stream >> param;
     121           80 :     return !stream.fail() && stream.eof();
     122           40 : }
     123              : 
     124              : inline auto nth_occurrence(std::string_view input_str, std::string_view search_str, std::size_t Nth)
     125              : {
     126              :     if (Nth == 0) {
     127              :         return std::string_view::npos;
     128              :     }
     129              :     std::string_view::size_type pos = 0;
     130              :     size_t cnt{};
     131              : 
     132              :     do {
     133              :         pos = input_str.find(search_str, pos);
     134              :         if (pos == std::string_view::npos) {
     135              :             return std::string_view::npos;
     136              :         }
     137              :         ++cnt;
     138              :         ++pos;
     139              :     } while (cnt != Nth);
     140              : 
     141              :     return pos;
     142              : }
     143              : 
     144              : // Returns the position **after** the nth occurrence of the search_char, eg:
     145              : // eg: Given a string test="aa,bb,cc", nth_occurrence(test, ',', x), for x = 1 it gives 3, and for x = 2 it gives 6
     146       852381 : inline auto nth_occurrence(std::string_view input_str, char const search_char, std::size_t Nth)
     147              : {
     148       852381 :     if (Nth == 0) {
     149            0 :         return std::string_view::npos;
     150              :     }
     151       852381 :     std::string_view::size_type pos = 0;
     152       852381 :     size_t cnt{};
     153              : 
     154              :     do {
     155      9092064 :         pos = input_str.find(search_char, pos);
     156      9092064 :         if (pos == std::string_view::npos) {
     157            0 :             return std::string_view::npos;
     158              :         }
     159      9092064 :         ++cnt;
     160      9092064 :         ++pos;
     161      9092064 :     } while (cnt != Nth);
     162              : 
     163       852381 :     return pos;
     164              : }
     165              : 
     166       568289 : template <typename... Param> bool readList(std::string_view input, Param &&...param)
     167              : {
     168              :     if constexpr (std::conjunction_v<std::is_same<double &, Param>...> || std::conjunction_v<std::is_same<int &, Param>...>) {
     169       568259 :         size_t index = 0;
     170       568259 :         return ((readListItem(input, index, param)), ...);
     171              :     } else {
     172           30 :         auto reader = stringReader(input);
     173           60 :         return ((readListItem(reader, param)), ...);
     174           30 :     }
     175              : }
     176              : 
     177              : } // namespace EnergyPlus
     178              : 
     179              : namespace ObjexxFCL {
     180              : // since this is a slice (reference) we want to bind to temporaries
     181              : // so we're going to allow that where the one provided by Array1S.hh does not
     182              : template <typename T> std::istream &operator>>(std::istream &stream, Array1S<T> &&a)
     183              : {
     184              :     // just pass on to the `&` version of this operator>>
     185              :     return stream >> a;
     186              : }
     187              : } // namespace ObjexxFCL
     188              : 
     189              : #endif
        

Generated by: LCOV version 2.0-1