SDL_GetGamepadAxisFromString - Man Page

Convert a string into SDL_GamepadAxis enum.

Synopsis

#include <SDL3/SDL_gamepad.h>

SDL_GamepadAxis SDL_GetGamepadAxisFromString(const char *str);

Description

This function is called internally to translate SDL_Gamepad mapping strings for the underlying joystick device into the consistent SDL_Gamepad mapping. You do not normally need to call this function unless you are parsing SDL_Gamepad mappings in your own code.

Note specially that "righttrigger" and "lefttrigger" map to SDL_GAMEPAD_AXIS_RIGHT_TRIGGER and SDL_GAMEPAD_AXIS_LEFT_TRIGGER, respectively.

Function Parameters

str

string representing a SDL_Gamepad axis.

Return Value

Returns the SDL_GamepadAxis enum corresponding to the input string, or SDL_GAMEPAD_AXIS_INVALID if no match was found.

Availability

This function is available since SDL 3.2.0.

See Also

SDL_GetGamepadStringForAxis(3)

Referenced By

SDL_GetGamepadStringForAxis(3).

SDL 3.2.16 Simple Directmedia Layer SDL3 FUNCTIONS