fuchsia - Fuchsia OS fxl::CommandLineFromArgcArgv() 用法？

Question

#include "src/lib/fsl/syslogger/init.h"
#include "src/lib/fxl/command_line.h"
int main(int argc, char** argv) {
    auto command_line = fxl::CommandLineFromArgcArgv(argc, argv);
    fsl::InitLoggerFromCommandLine(command_line, {"my_program"});
}

Fuchsia OS > Reference没有列出 FXL：

对Fuchsia Project 站点的搜索有一个额外的示例，该示例具有fxl::CommandLineFromArgcArgv().

我在哪里可以找到参数、返回值和其他详细信息fxl::CommandLineFromArgcArgv()？

score 1 · Accepted Answer

fxlAPI 没有记录为官方 Fuchsia 参考的一部分（目前）。

从目录中的自述fxl文件（链接）：

在理想的世界中，FXL 不存在，我们可以使用 C++ 标准库的构建块。[...] 我们希望 FXL 保持较小，并专注于“修复”C++ 标准库的问题，这意味着您可能不应该将您的东西放在 FXL 中，除非它与 C++ 的特定缺陷有关标准库。

基于此声明，它似乎fxl不是一个长期项目，而是在 C++ 标准库已充分适应时变得空/过时。由于这个原因，文档工作可能受到限制。

我们必须依赖直接在标题（链接）中提供的文档：

// Builds a |CommandLine| from the usual argc/argv.
inline CommandLine CommandLineFromArgcArgv(int argc, const char* const* argv)

该类CommandLine在同一个标头中定义。根据评论，它区分了可选参数和位置参数。可选参数的形式为--key=valueor --key（没有值），但不是--key value。位置参数以不是这种形式的第一个参数（或特殊--分隔符）开始。

CommandLine成员函数是：

访问程序名称（来自argv[0]）：

bool has_argv0() const;
const std::string& argv0() const;

访问可选参数和位置参数（Option作为带有成员std::string name/的简单结构std::string value）：
```
const std::vector<Option>& options() const;
const std::vector<std::string>& positional_args() const;
```

比较：

bool operator==(const CommandLine& other) const;
bool operator!=(const CommandLine& other) const;

访问可选参数：

bool HasOption(StringView name, size_t* index = nullptr) const;
bool GetOptionValue(StringView name, std::string* value) const;
std::vector<StringView> GetOptionValues(StringView name) const;
std::string GetOptionValueWithDefault(StringView name, StringView default_value) const;

我们可以编写以下示例程序（使用结构化绑定语法）：

#include <iostream>
#include "src/lib/fxl/command_line.h"

int main(int argc, char** argv) {
  const auto cl = fxl::CommandLineFromArgcArgv(argc, argv);

  std::cout << "Program name = " << cl.argv0() << std::endl;

  std::cout << "Optional: " << cl.options().size() << std::endl;

  for (const auto& [name,value] : cl.options()) {
    std::cout << name << " -> " << value << std::endl;
  }

  std::cout << "Positional: " << cl.positional_args().size() << std::endl;

  for (const auto& arg : cl.positional_args()) {
    std::cout << arg << std::endl;
  }

  return 0;
}

编译程序后（基于this answer），我们可以获得以下输出（演示第一个位置参数如何filename将所有后续参数转换为位置参数）：

$ hello_world_cpp --k1=v1 --k2 --k3=v3 filename --k4=v4
Program name = hello_world_cpp
Optional: 3
k1 -> v1
k2 ->
k3 -> v3
Positional: 2
filename
--k4=v4

演示--为分隔符：

$ hello_world_cpp --k1=v1 -- --k2=v2
Program name = hello_world_cpp
Optional: 1
k1=v1
Positional: 1
--k2=v2

我们可以使用以下方法进行简单的参数解析HasOption：

    size_t index;

    if (cl.HasOption("key", &index)) {
      handle_key(cl.options.at(index).value);
    }

将此添加到我们的程序并调用它，--key=abc然后将传递abc给handle_key.

fuchsia - Fuchsia OS fxl::CommandLineFromArgcArgv() 用法？

1 回答 1

Related

Reference