int IMG_isXPM(SDL_RWops *src)
src | チェックする画像の読込/シーク可能なSDL_RWops |
XPM画像のとき0以外, そうでないとき0を戻す.
この関数は, ファイルのSDL_RWopsからできるだけ少なく(通常は数バイト)読み込んでファイルの種類を判別しようとする.
「チェック対象のファイル種別でない」こととI/Oエラーの区別は行わない.
この関数が呼ばれると, RWopsを常に呼ばれた時点にシークして戻そうとするが, シーク時にエラーが発生しても何も報告せず正常に動作したとみなす. これは直後に別の種類のIMG_isType関数を使用する, または追加のシークをせずに画像を読み込めることを意味する.
画像データの読み込み前にこの関数を呼ぶ必要はない. 多くの場合, SDL_imageの標準の読み込み関数はファイルの種別をチェックしている.