FBB::Hostent(3bobcat)

📦
version 6.15.01 · 7 versions
, in ubuntu stonking

💖 FBB::Hostent — it's in the 3bobcat manual, bestie 💖

okay so welcome to FBB::Hostent(3bobcat), the lil' struct-hostent-wrapper that lives in the bobcat fam. she's giving "glow-up for a C struct" and honestly? she ate. 🦋

✨ NAME ✨

FBB::Hostent — a Wrapper around a struct hostent. that's it, that's the whole vibe 💅

✨ SYNOPSIS ✨

#include <bobcat/hostent>
Linking option: -lbobcat

yk how you link things — you gotta pass -lbobcat or she simply will not show up. periodt. 🎀

🌸 DESCRIPTION 🌸

@CLASS objects are wrappers around hostent structs, and other objects can use them, which is the entire point, no cap. a struct hostent is defined like this, and you're getting it verbatim because we do not mess with the lore:

struct hostent
{
    char    *h_name;        // official name of host
    char    **h_aliases;    // alias list
    int     h_addrtype;     // host address type (always AF_INET)
    int     h_length;       // length of address
    char    **h_addr_list;  // list of addresses
}

so the address fields are binary values of the addresses, and every single address needs h_length bytes to itself. the last address is equal to 0, which is the little "we're done here" signal 🛑. the @CLASS objects are out here offering a C++-like interface to this struct, and honestly she's iconic for it. ✨

💜 NAMESPACE 💜

FBB

every constructor, member, operator and manipulator mentioned in this man-page (yes, all of them, i checked 🫶) is defined in the namespace FBB.

🌈 INHERITS FROM 🌈

-

that's a big fat nothing bestie. she inherits from no one. she's self-made. main character energy fr fr. 👑

🎀 CONSTRUCTORS 🎀

  • Hostent(hostent const *hostentPtr) — this constructor initializes an @CLASS object from an existing hostent struct. and like, functions such as gethostbyname(3) and gethostbyaddress(3) return pointers to hostent structs, so that's where you'd get your pointer from. 🔥

the default, copy and move constructors (and the copy and move assignment operators) are all available too — so you can copy her, move her, whatever. she's flexible. 💅

🦋 MEMBER FUNCTIONS 🦋

  • size_t addressLength() const — gives you the length of the binary addresses, in bytes. 📏
  • size_t addressType() const — gives you the type of the address. currently this is always AF_INET. always. every time. 😌
  • char const *alias(size_t index) const — gives you alias index of the host, and the first alias has index 0 (zero-indexed girlies rise up 🙈). if alias index doesn't exist, you get 0 back. no alias, no problem.
  • char const * const *beginAlias() const — gives you an iterator to the first alias. heads up tho: the hostname itself is not included in the list of aliases. she's separate. independent. 💅
  • char const *binaryAddress(size_t index) const — gives you the binary address index of the host, first address is index 0. if address index doesn't exist, 0 comes back. the pointer to the binary address points to a series of addressLength() bytes. note — the returned address is in network byte order, and you can convert it to host byte order with the functions described in byteorder(3). so flip it if you need to, bestie. 🔄
  • std::string dottedDecimalAddress(size_t index) const — gives you address index as a dotted decimal address, in a string, nice and readable. first address is index 0. if address index doesn't exist, you get an empty string. 🫙
  • char const * const *endAlias() const — gives you an iterator pointing beyond the last alias. classic end-iterator behaviour, we love a range. ✨
  • char const *hostname() const — gives you the standard (first) name of the host. her government name, if you will. 📛
  • size_t nAddresses() const — gives you the number of addresses available. so when you're requesting a particular address, the index you ask for should be less than the value this member returns. otherwise, nothing. 🚫
  • size_t nAliases() const — gives you the number of aliases available. same rule, bestie: when requesting a particular alias, the index you ask for should be less than the value this member returns. 💯
  • void swap(Hostent &other) — swaps the current Hostent object's content with the other object's content. theirs is yours, yours is theirs, we're trading 🫶

🌟 EXAMPLE 🌟

here's a whole program, copy it exactly, don't be shy:

#include <iostream>
#include <algorithm>
#include <iterator>
#include <bobcat/hostent>

using namespace std;
using namespace FBB;

int main(int argc, char **argv)
{
    Hostent he(gethostbyname("localhost"));

    cout << "The local hostname = " << he.hostname() << endl;

    cout << "All aliases: " << endl;
    copy(he.beginAlias(), he.endAlias(),
                ostream_iterator<char const *>(cout, "\n"));

    cout << "Addresses:\n";
    for (size_t idx = 0; idx < he.nAddresses(); idx++)
        cout << he.dottedDecimalAddress(idx) << endl;
}

look at her go. localhost, aliases, addresses, the whole slay. 🔥

🍓 FILES 🍓

  • bobcat/hostent — defines the class interface. that's where she lives. that's her address (pun absolutely intended). 🏠

💀 SEE ALSO 💀

bobcat(7)

🙈 BUGS 🙈

None Reported.

(we love a clean bug report. ngl, very demure, very mindful. ✨)

👑 BOBCAT PROJECT FILES 👑

Debian Bobcat project files:

  • libbobcat6 — debian package containing the shared library, changelog and copyright note;
  • libbobcat-dev — debian package containing the static library, headers, manual pages, and developer info;

🌈 BOBCAT 🌈

Bobcat is an acronym of Brokken's Own Base Classes And Templates.

like. the name is a whole acronym. that's so cool of her. 🫶

This is free software, distributed under the terms of the GNU General Public License (GPL).

free software, free as in freedom, free as in you can literally just have it. 💅

🌸 AUTHOR 🌸

Frank B. Brokken (f.b.brokken@rug.nl).

and that's the whole page, bestie!! this one came out as libbobcat-dev_6.15.01 and she's been doing her thing from 2005-2026 — a whole era, honestly, she's been serving FBB::Hostent(3bobcat) since forever. mwah. 💋💖✨🦋🎀

📦 where this page comes from