IMG_isCUR(3)

💖 IMG_isCUR(3) 💖

Okay bestie, welcome to the SDL_image3 FUNCTIONS page for IMG_isCUR(3) ✨ This is your little vibe check for CUR image data, and we’re gonna get into it.

---

🌸 NAME 🌸

IMG_isCUR — detect CUR image data on a readable/seekable SDL_IOStream. 💅

---

🎀 SYNOPSIS 🎀

#include <SDL3_image/SDL_image.h>

bool IMG_isCUR(SDL_IOStream *src);

---

🦋 DESCRIPTION 🦋

Okay so this function attempts to determine if a file is a given filetype, reading the least amount possible from the SDL_IOStream — usually just a few bytes. Lowkey efficient, no cap. ⭐

Real talk: there is no distinction made between “not the filetype in question” and basic i/o errors. It’s giving “we’re not gonna overexplain that part” energy. 💀

This function will always attempt to seek src back to where it started when this function was called, but it will not report any errors in doing so. But assuming seeking works, that means you can immediately use this with a different IMG_isTYPE function, or load the image without further seeking. So convenient, honestly 🫶

You do not need to call this function to load data; SDL_image can work to determine file type in many cases in its standard load functions. So this is more like a little peek than a mandatory step ✨

---

🧚 FUNCTION PARAMETERS 🧚

• src — a seekable/readable SDL_IOStream to provide image data. 🎀

---

🌈 RETURN VALUE 🌈

Returns true if this is CUR data, false otherwise. Periodt. 👑

---

⭐ AVAILABILITY ⭐

This function is available since SDL_image 3.0.0. Iconic behavior since day one, fr fr 💖

---

🔥 SEE ALSO 🔥

Go show these sibling functions some love too, bestie 😭💜

• IMG_isANI(3)
• IMG_isAVIF(3)
• IMG_isBMP(3)
• IMG_isGIF(3)
• IMG_isICO(3)
• IMG_isJPG(3)
• IMG_isJXL(3)
• IMG_isLBM(3)
• IMG_isPCX(3)
• IMG_isPNG(3)
• IMG_isPNM(3)
• IMG_isQOI(3)
• IMG_isSVG(3)
• IMG_isTIF(3)
• IMG_isWEBP(3)
• IMG_isXCF(3)
• IMG_isXPM(3)
• IMG_isXV(3)

---

This page is serving SDL_image 3.4.4 energy, and that’s the cute little sign-off: source SDL_image, version 3.4.4, mwah 💋✨