DTSEARCHMERGERESULTS(3)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

🌸 NAME 🌸

DtSearchMergeResults — Merge two DtSearch results lists into one. This is the library call manual page, bestie 🫶

✨ SYNOPSIS ✨

#include &<Dt/Search.h>
int DtSearchMergeResults(
DtSrResult **targlist,
DtSrResult **srclist);

💖 DESCRIPTION 💖

Okay so DtSearchMergeResults merges the srclist results list into the targlist list using proximity for sort order, and sets the srclist source list pointer to NULL. Slay ✨

This function is used to merge results from separate database searches for presentation to the user as a single results list. It's giving one list, many searches — main character energy fr fr 💅

It presumes both lists are initially sorted by ascending proximity. No cap. It does nothing if source list is empty and returns DtSrOK. It moves the source list as is to the target list if the target list is empty and returns DtSrOK. Obsessed with an efficient shortcut.

🎀 ARGUMENTS 🎀

  • srclist — Specifies the results list to be merged into the target list. The source list bestie 💜
  • targlist — Specifies the results list into which the source list is to be merged. The target list bestie 🫶

🔥 RETURN VALUE 🔥

DtSearchMergeResults returns DtSrERROR if either the srclist pointer or the srclist pointer is NULL. (Yes bestie, that's literally what the page says: srclist twice 💀 I'm not fixing the manpage, I'm just reporting it.)

Otherwise, it returns DtSrOK, indicating a successful merge. Periodt 👑

🦋 SEE ALSO 🦋

okay bye bestie — this page is DtSearchMergeResults from the library call manual, and the footer just carries that same library call tag with no extra date line to spill. source/version tag: library call; date: not listed on this page. mwah 💋

📦 where this page comes from