Attean...inding(3pm)

💖 NAME 💖

Attean::API::Binding — Name to term bindings. hii bestie, this is the Attean...inding(3pm) page from the User Contributed Perl Documentation crew, and we are keeping every lil detail. periodt. 💅

✨ VERSION ✨

This document describes Attean::API::Binding version 0.035. 🎀

🦋 DESCRIPTION 🦋

The Attean::API::Binding role defines a common API for all objects that map names to Attean::API::Term objects. That includes triples, quads, and SPARQL results, aka variable bindings. it's giving shared interface excellence. ✨

🎀 REQUIRED METHODS 🎀

If a class consumes this role, it must provide these methods — no cap, they are required:

• value( $name ) — Returns the Attean::API::Term object mapped to the variable named $name, or undef if no such term is mapped. 🫶
• variables — Returns a list of the variable names mapped to Attean::API::Term objects in this mapping. 📋
• apply_map( $mapper ) — Returns a new mapping object, of the same class as the referent, with term objects rewritten using the supplied Attean::Mapper object $mapper. 🔁

🌸 METHODS 🌸

This role provides default implementations of the following methods:

• mapping — Returns a HASH mapping variable names to Attean::API::Term objects. 🗂️
• values — Returns a list of Attean::API::Term objects corresponding to the variable names returned by the referent's variables method. 💖
• tuples_string — Returns a string serialization of the Attean::API::Term objects in the order they are returned by the referent's values method. 🔤
• as_string — Returns a string serialization of the variable bindings. 🧵
• has_blanks — Returns true if any variable is bound to an Attean::API::Blank term, false otherwise. 🕳️
• sameTerms( $other ) — listed as a default implementation here; the original does not give this one a separate description, and we are not inventing one, bestie. 🫶
• equals( $other ) — same vibe: listed as a default implementation, no extra blurb in the original. 💅
• blanks — Returns all the values in this mapping, recursively if any values are embedded bindings, that are blank nodes. 🌫️
• referenced_variables — Returns a list of the names of any variable values that are referenced in this binding, recursively if any values are embedded bindings. 🔎
• is_ground — Returns true if all the bound values consume Attean::API::Term, false otherwise. The original page has a lil typo here — it says tue 😭 — but you get the vibe. ⚡
• values_consuming_role( $role ) — Returns the list of bound values that consume $role. 👑
• tree_attributes — Returns the variables which are bound in this object. 🌳
• apply_bindings( $binding ) — Construct a new binding by replacing variables with their bound values from $binding. 🧚
• parse ( $string ) — Returns a triple or quad pattern object using the variables and/or terms parsed from $string in SPARQL syntax. 🪄
• project( @keys ) — Returns a new Attean::Result binding which contains variable-value mappings from the invocant for every variable name in @keys. 🎯

💀 BUGS 💀

Please report any bugs or feature requests to through the GitHub web interface at https://github.com/kasei/attean/issues — yes, the original wording says “to through”, so we are keeping that lil detail. do not come for me, I am just the messenger. 😭

👀 SEE ALSO 👀

okay so this section is literally empty in the original — no entries listed, no cross-references, nothing. Not me skipping it; there is just nothing to put here, bestie. 💀

🌈 AUTHOR 🌈

Gregory Todd Williams "<gwilliams@cpan.org>" 🫶

⭐ COPYRIGHT ⭐

Copyright (c) 2014--2022 Gregory Todd Williams. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 🎀

Later, bestie 💖 — this page is from perl v5.40.0, dated 2025-01-26, and it is the Attean...inding(3pm) manual. Slay. 🌈