https://github.com/willkill07/named-tuple

https://github.com/willkill07/named-tuple

cpp cpp-lib cpp-library cpp-templates cpp20 cpp20-lib cpp20-library header-only header-only-lib header-only-library modern-cpp

Last synced: 3 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/willkill07/named-tuple
• Owner: willkill07
• License: cc0-1.0
• Created: 2023-09-01T17:44:34.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-09-01T23:18:54.000Z (about 1 year ago)
• Last Synced: 2023-09-02T17:02:40.035Z (about 1 year ago)
• Topics: cpp, cpp-lib, cpp-library, cpp-templates, cpp20, cpp20-lib, cpp20-library, header-only, header-only-lib, header-only-library, modern-cpp
• Language: C++
• Homepage:
• Size: 7.81 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

README

        
# named-tuple

Single header implementation a named-tuple in C++

Tuples have always been addressible via index and type -- the obvious gap here is accessing by name. This (small) header-only library provides just that!

### Usage

```cpp

auto make_config() {

    using Configuration = named_tuple<

      named_val,

      named_val,

      named_val,

      named_val

    >;

    Configuration default_config{"/usr/local/", "./build", 1, true};

    return default_config;

}

void use_config(auto&& config) {

    // named_get supports multiple values and will construct an intermediate named_tuple

    auto build_options = named_get<"build-path", "retry-limit">;

    auto install_options = named_get<"install-path", "system-wide">;

}

```

### Components

- `named_tuple`: The tuple class - `sizeof(named_tuple) == sizeof(tuple)`

- `named_val`: descriptor used to indicate the type and name

- `named_get<"name">`: accessor for retrieving a value stored in the `named_tuple`

- `named_get`: accessor for splicing a `named_tuple`. You can even permute!

- `named_tie`: std::tie() equivalent for `named_tuple`

### Limitations

* Deduction guides are not really feasible due to their limitation of needing all template arguments specified.

* I have not extensively tested the reference semantics and behavior. I welcome contributions to this library.

### Compiler support

Requires a small subset of C++20 features.

Tested on:

- Linux

  * g++ 13.0

  * clang 16.0

- macOS

  * g++ 13.0

  * clang 16.0

  * AppleClang 14.0

----------

[![CC0](http://i.creativecommons.org/p/zero/1.0/88x31.png)]("http://creativecommons.org/publicdomain/zero/1.0/")

To the extent possible under law, [Will Killian](https://github.com/willkill07) has waived all copyright and related or neighboring rights to the `expected` library. This work is published from: the United States of America.