DTDTSDATATODATATYPE(3)

okay bestie, welcome to the DtDtsDataToDataType(library call) page 💅✨ — this is the one where we figure out what a set of data is, and honestly it’s giving main-character energy. No cap, let’s get into it.

🌸 NAME 🌸

• DtDtsDataToDataType — get the data type for a set of data

✨ SYNOPSIS ✨

#include &<Dt/Dts.h>
char *DtDtsDataToDataType(
const char *filepath,
const void *buffer,
const int size,
const struct stat *stat_buff,
const char *link_path,
const struct stat *link_stat_buff,
const char *opt_name);

💖 DESCRIPTION 💖

The DtDtsDataToDataType function determines the data type of a set of data, based on the information given in the non-NULL pointer arguments to the function. The function gathers any additional information, if it is needed, to compensate for the NULL arguments. For example, if the filepath argument is given, but the stat_buff argument is NULL and a stat_buff value is required to determine the data type, DtDtsDataToDataType calls the stat(2) function to obtain the information.

Here’s the argument tea, one by one 🍓:

• filepath — the pathname of a file.
• buffer — a pointer to the buffer of the data to be typed.
• size — the size of the buffer in bytes.
• stat_buff — the buffer returned from a stat(2) or fstat(3) call for use in typing.
• link_path — the pathname of the target file pointed to by a symbolic link.
• link_stat_buff — the buffer returned from an lstat(2) call for use in typing.
• opt_name — can be used to specify a name to be associated with the buffer. If the opt_name argument is not NULL, it is used as a pseudo file name in typing; otherwise, certain attributes may be returned as NULL because the filename components could not be determined.

bestie, that opt_name bit matters: no pseudo file name can mean some attributes come back as NULL. lowkey important 💅

🎀 RETURN VALUE 🎀

Upon successful completion, the DtDtsDataToDataType function returns a pointer to a data type string, or NULL if no value could be determined.

🦋 APPLICATION USAGE 🦋

The DtDtsDataToDataType function is generally used by applications such as file managers to improve performance. Typical applications should probably use DtDtsFileToDataType(3) or DtDtsBufferToDataType(3) instead.

The DtDtsBuffer* functions assume that the buffer is readable and writable by the user, group and other file classes and select a type accordingly. An application requiring a type based on read-only permissions should use DtDtsDataToDataType with a stat_buff value created for this purpose: all fields should NULL except for the st_mode field, which should be set to:

S_IFREG | S_IROTH | S_IRGRP | S_IRUSR

🔥 SEE ALSO 🔥

• Dt/Dts.h
• DtDtsLoadDataTypes(3)
• DtDtsFileToDataType(3)
• DtDtsBufferToDataType(3)
• fstat(3)
• lstat(2)
• stat(2)

---

and that’s the page, bestie 🫶💖 the footer is just DtDtsDataToDataType(library call) — no extra source/version or date tea on this one. mwah 💋✨