Accept command arguments as array views

Author: SineStriker

include/stdcorelib/support/commandline.h

@@ -1537,14 +1537,14 @@ namespace stdc::cli {
         ///      does not walk the tree before parsing.
         /// \note A program whose command tree is built dynamically, such as from plugins,
         ///       should call validate() explicitly before this even in a release build.
-        inline ParseResult parse(const std::vector<std::string> &args,
+        inline ParseResult parse(array_view<std::string> args,
                                  ParseOptions parseOptions = Standard) const {
             assert(!validate(parseOptions).has_value() && "the command tree is invalid");
             return parseImpl(args, parseOptions);
         }
         /// Parses and does everything a \c main does with the answer, reporting a failure and
         /// answering a Help or Version option before any handler runs. \sa ParseResult::invoke()
-        inline int invoke(const std::vector<std::string> &args, int errorCode = -1,
+        inline int invoke(array_view<std::string> args, int errorCode = -1,
                           ParseOptions parseOptions = Standard) const {
             return parse(args, parseOptions).invoke(errorCode);
         }
@@ -1565,8 +1565,7 @@ namespace stdc::cli {
         }
 
     private:
-        ParseResult parseImpl(const std::vector<std::string> &args,
-                              ParseOptions parseOptions) const;
+        ParseResult parseImpl(array_view<std::string> args, ParseOptions parseOptions) const;
 
         class Impl;
         std::unique_ptr<Impl> _impl;

src/support/commandline.cpp

@@ -1113,7 +1113,7 @@ namespace stdc::cli {
             ParserCore(detail::parse_data *out, Parser::ParseOptions flags) : r(out), flags(flags) {
             }
 
-            void run(const std::vector<std::string> &args);
+            void run(array_view<std::string> args);
 
         private:
             using Error = ParseResult::Error;
@@ -1799,7 +1799,7 @@ namespace stdc::cli {
             }
         }
 
-        void ParserCore::run(const std::vector<std::string> &args) {
+        void ParserCore::run(array_view<std::string> args) {
             // The first argument names the program rather than anything to parse.
             tokens.assign(args.begin() + (args.empty() ? 0 : 1), args.end());
             if (on(Parser::EnableResponseFile)) {
@@ -1999,8 +1999,7 @@ namespace stdc::cli {
                                      parseOptions.test_flag(IgnoreCommandCase));
     }
 
-    ParseResult Parser::parseImpl(const std::vector<std::string> &args,
-                                  ParseOptions parseOptions) const {
+    ParseResult Parser::parseImpl(array_view<std::string> args, ParseOptions parseOptions) const {
         stdc_impl_t;
         ParseResult result;
         auto &out = *result._impl;

tests/auto/support/test_commandline.cpp

@@ -1,5 +1,6 @@
 // SPDX-License-Identifier: MIT
 
+#include <array>
 #include <cmath>
 #include <cstdint>
 #include <cstdio>