LCOV - code coverage report
Current view: top level - EnergyPlus - StringUtilities.hh (source / functions) Coverage Total Hit
Test: lcov.output.filtered Lines: 96.1 % 51 49
Test Date: 2025-05-22 16:09:37 Functions: 100.0 % 22 22

            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           38 : inline std::stringstream stringReader(std::string_view str)
      59              : {
      60           38 :     std::stringstream result{str.data()};
      61              :     // result.imbue(std::locale("C"));
      62           38 :     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       718448 : bool readListItem(std::string_view input, size_t &index, T &param)
      67              : {
      68       718448 :     if (index >= input.size()) return false;
      69              : 
      70       718448 :     input.remove_prefix(index);
      71              : 
      72       718448 :     auto first_comma = input.find_first_not_of(',');
      73       718448 :     if (first_comma != std::string_view::npos) {
      74       718448 :         input.remove_prefix(first_comma);
      75              :     }
      76              : 
      77       718448 :     auto first_char = input.find_first_not_of(' ');
      78       718448 :     if (first_char != std::string_view::npos) {
      79       718448 :         input.remove_prefix(first_char);
      80              :     }
      81              : 
      82       718448 :     FromChars::from_chars_result result{};
      83              :     if constexpr (std::is_same_v<T, int>) {
      84       138160 :         result = FromChars::from_chars(input.data(), input.data() + input.size(), param);
      85              :     } else if constexpr (std::is_same_v<T, double>) {
      86       580288 :         auto fast_float_result = fast_float::from_chars(input.data(), input.data() + input.size(), param);
      87       580288 :         result.ptr = fast_float_result.ptr;
      88       580288 :         result.ec = fast_float_result.ec;
      89              :     }
      90       718448 :     if (result.ec == std::errc::result_out_of_range || result.ec == std::errc::invalid_argument) {
      91            0 :         return false;
      92              :     }
      93       718448 :     size_t pos = result.ptr - input.data();
      94       718448 :     index += (pos + first_comma + first_char);
      95       718448 :     return true;
      96              : }
      97              : 
      98          132 : template <typename Param> bool readListItem(std::istream &stream, Param &&param)
      99              : {
     100          132 :     if (stream.good()) {
     101          124 :         stream >> param;
     102          124 :         if (stream.good() && stream.peek() == ',') {
     103            3 :             stream.get(); // eat comma
     104              :         }
     105              :     } else {
     106              :         // the stream was not good, it was, perhaps EOF. So we need to
     107              :         // set the fail bit here to say that we ran out of string
     108              :         // and were unable to read the next bit of data
     109            8 :         stream.setstate(std::ios_base::failbit);
     110              :     }
     111              : 
     112          132 :     return !stream.fail();
     113              : }
     114              : 
     115           19 : template <typename Param> bool readItem(std::string_view input, Param &&param)
     116              : {
     117           19 :     auto stream = stringReader(input);
     118           19 :     stream >> param;
     119           38 :     return !stream.fail() && stream.eof();
     120           19 : }
     121              : 
     122              : inline auto nth_occurrence(std::string_view input_str, std::string_view search_str, std::size_t Nth)
     123              : {
     124              :     if (Nth == 0) return std::string_view::npos;
     125              :     std::string_view::size_type pos = 0;
     126              :     size_t cnt{};
     127              : 
     128              :     do {
     129              :         pos = input_str.find(search_str, pos);
     130              :         if (pos == std::string_view::npos) {
     131              :             return std::string_view::npos;
     132              :         }
     133              :         ++cnt;
     134              :         ++pos;
     135              :     } while (cnt != Nth);
     136              : 
     137              :     return pos;
     138              : }
     139              : 
     140              : // Returns the position **after** the nth occurrence of the search_char, eg:
     141              : // 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
     142        82896 : inline auto nth_occurrence(std::string_view input_str, char const search_char, std::size_t Nth)
     143              : {
     144        82896 :     if (Nth == 0) return std::string_view::npos;
     145        82896 :     std::string_view::size_type pos = 0;
     146        82896 :     size_t cnt{};
     147              : 
     148              :     do {
     149       884224 :         pos = input_str.find(search_char, pos);
     150       884224 :         if (pos == std::string_view::npos) {
     151            0 :             return std::string_view::npos;
     152              :         }
     153       884224 :         ++cnt;
     154       884224 :         ++pos;
     155       884224 :     } while (cnt != Nth);
     156              : 
     157        82896 :     return pos;
     158              : }
     159              : 
     160        55283 : template <typename... Param> bool readList(std::string_view input, Param &&... param)
     161              : {
     162              :     if constexpr (std::conjunction_v<std::is_same<double &, Param>...> || std::conjunction_v<std::is_same<int &, Param>...>) {
     163        55266 :         size_t index = 0;
     164        55266 :         return ((readListItem(input, index, param)), ...);
     165              :     } else {
     166           17 :         auto reader = stringReader(input);
     167           34 :         return ((readListItem(reader, param)), ...);
     168           17 :     }
     169              : }
     170              : 
     171              : } // namespace EnergyPlus
     172              : 
     173              : namespace ObjexxFCL {
     174              : // since this is a slice (reference) we want to bind to temporaries
     175              : // so we're going to allow that where the one provided by Array1S.hh does not
     176              : template <typename T> std::istream &operator>>(std::istream &stream, Array1S<T> &&a)
     177              : {
     178              :     // just pass on to the `&` version of this operator>>
     179              :     return stream >> a;
     180              : }
     181              : } // namespace ObjexxFCL
     182              : 
     183              : #endif
        

Generated by: LCOV version 2.0-1