SDL_strupr(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

🌸 SDL_strupr — bestie edition 💅

okay so this is SDL_strupr(3), one of the SDL3 FUNCTIONS ✨ it's the glow-up function: it takes a string and makes it ALL CAPS. uppercase era. periodt. 👑

✨ NAME ✨

SDL_strupr</p> — convert a string to uppercase 💖

📜 SYNOPSIS 📜

#include <SDL3/SDL_stdinc.h>

char * SDL_strupr(char *str);

like, that's the whole vibe. one include, one function, no drama 🫶

🦋 DESCRIPTION 🦋

⚠️ WARNING: regardless of system locale, this will only convert ASCII values 'A' through 'Z' to uppercase.

okay so that warning? read it twice, bestie. regardless of system locale. it does not care about your locale. it does not care about your vibes. it only touches ASCII. 😭

This function operates on a null-terminated string of bytes — and yes, even if it is malformed UTF-8! 🙈 it literally does not check. it does not care. it just goes.

What it does: converts ASCII characters 'a' through 'z' to their uppercase equivalents in-place, and returns the original str pointer. in-place, meaning it edits the string you handed it. no copy, no new allocation, no extra credit. slay. 🔥

🎀 FUNCTION PARAMETERS 🎀

  • str — the string to convert in-place. Can not be NULL. 🚫 like fr fr, do not pass NULL. do not test it. do not be curious. 🫶

💖 RETURN VALUE 💖

Returns the str pointer passed into this function. the same pointer. the identical one. it's giving "you get back exactly what you gave me" energy ✨ no surprises, no plot twist, iconic behavior honestly 👑

🌈 THREAD SAFETY 🌈

It is safe to call this function from any thread. ✅ main character energy available on every thread, no gatekeeping 💜

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. if you're on anything older, sorry bestie, it's not there yet 😔

👀 SEE ALSO 👀

  • SDL_strlwr(3) — the lowercase sibling 🧚 the yin to this yang, the down to this up, the lowercase era to this uppercase era 💅

okay that's the whole page!! 🎀 that was SDL_strupr(3) from the Simple Directmedia Layer docs, SDL 3.4.18 edition — go forth, uppercase your strings, and remember: it's ASCII only, it's in-place, and str can not be NULL. no cap. bye bestie 💖✨🦋🌸

📦 where this page comes from