TCUTEST(1)

💖 TCUTEST(1) — bestie edition 💖

okay so you found the tcutest page in the Tokyo Cabinet manual, and honestly? you're gonna eat this one up. it's a manual page, page 1, and it is all about testing the utility API. let's get into it 🫶

✨ NAME ✨

tcutest — test cases of the utility API

like. it tests the utility API. that's the whole vibe. no cap.

🌸 DESCRIPTION 🌸

so the command tcutest is a utility for facility test and performance test. literally, that's its job. it's the friend who runs the drills so you don't have to 🙈

this command is used in the following format. quick vocab check before we go any further, bestie:

• rnum specifies the number of iterations.
• anum specifies the initial number of elements of array.
• bnum specifies the number of buckets.

periodt. now the formats:

tcutest xstr rnum

perform test of extensible string. ✨

tcutest list [-rd] rnum [anum]

perform test of array list. 🎀

tcutest map [-rd] [-tr] [-rnd] [-dk|-dc|-dai|-dad|-dpr] rnum [bnum]

perform test of hash map. 👑

tcutest tree [-rd] [-tr] [-rnd] [-dk|-dc|-dai|-dad|-dpr] rnum

perform test of ordered tree. 🌸

tcutest mdb [-rd] [-tr] [-rnd] [-dk|-dc|-dai|-dad|-dpr] rnum [bnum]

perform test of on-memory hash database. 🦋

tcutest ndb [-rd] [-tr] [-rnd] [-dk|-dc|-dai|-dad|-dpr] rnum

perform test of on-memory tree database. 💜

tcutest misc rnum

perform test of miscellaneous routines. ✨

tcutest wicked rnum

perform updating operations of list and map selected at random. it's giving chaos, it's giving main character energy 💅

the options, and yes they're iconic

options feature the following.

• -rd — perform the reading test also.
• -tr — perform the iterator test also.
• -rnd — select keys at random.
• -dk — use the function tcxxxputkeep instead of tcxxxput.
• -dc — use the function tcxxxputcat instead of tcxxxput.
• -dai — use the function tcxxxaddint instead of tcxxxput.
• -dad — use the function tcxxxadddouble instead of tcxxxput.
• -dpr — use the function tcxxxputproc instead of tcxxxput.

(not me obsessed with -rnd… random keys? slay. 🔥)

exit status

this command returns 0 on success, another on failure. lowkey the simplest contract in the whole manual and we respect it 🫶

🌈 SEE ALSO 🌈

• tcumttest(1)
• tcucodec(1)
• tcutil(3)
• tokyocabinet(3)

and that's the whole page, bestie — mwah 💋

this was a Tokyo Cabinet man page, rendered from the Man Page edition dated 2012-08-18. if you made it this far you're literally a Unix legend now 👑💖