# love.keyboard.setKeyRepeat

Enables or disables key repeat for love.keypressed. It is disabled by default.

## Function

Available since LÖVE 0.9.0
This variant is not supported in earlier versions.

### Synopsis

    love.keyboard.setKeyRepeat( enable )

### Arguments

`boolean enable`
  Whether repeat keypress events should be enabled when a key is held down.

### Returns

Nothing.

### Notes

The interval between repeats depends on the user's system settings.

## Function

Removed in LÖVE 0.9.0
This variant is not supported in that and later versions.

Enables key repeating and sets the delay and interval.

### Synopsis

    love.keyboard.setKeyRepeat( delay, interval )

### Arguments

`number delay`
  The amount of time before repeating the key (in seconds). 0 disables key repeat.
`number interval`
  The amount of time between repeats (in seconds)

### Returns

Nothing.

## Examples

Available since LÖVE 0.9.0
This example is not supported in earlier versions.

Hold left or right to change the position.

    function love.load()
    	love.keyboard.setKeyRepeat(true)
    	x = 50
    end

    function love.keypressed(key, isrepeat)
    	if key == "right" then
    		x = (x + 80) % love.graphics.getWidth()
    	elseif key == "left" then
    		x = (x - 80) % love.graphics.getWidth()
    	end
    end

    function love.draw()
    	love.graphics.circle("fill", x, 100)
    end

Removed in LÖVE 0.9.0
This example is not supported in that and later versions.

Hold left or right to continue moving. Please note that a generally better way to move an object would be to put code in love.update() which uses love.keyboard.isDown. This is just an example.

    function love.load()
    	x = 400
    	love.keyboard.setKeyRepeat(0.01, 0.2)
    end

    function love.keypressed(key)
    	if key == "left" then
    		x = x - 20
    	elseif key == "right" then
    		x = x + 20
    	end
    end

    function love.draw()
    	love.graphics.circle("fill", x, 300, 30, 30)
    end

## See Also

- love.keyboard
- love.keyboard.hasKeyRepeat
- love.keypressed

##

Category:

- Functions