Interface Preferences


  • public interface Preferences

    A Preference instance is a hash map holding different values. It is stored alongside your application (SharedPreferences on Android, LocalStorage on GWT, on the desktop a Java Preferences file in a ".prefs" directory will be created, and on iOS an NSMutableDictionary will be written to the given file). CAUTION: On the desktop platform, all libGDX applications share the same ".prefs" directory. To avoid collisions use specific names like "com.myname.game1.settings" instead of "settings".

    To persist changes made to a preferences instance flush() has to be invoked. With the exception of Android, changes are cached in memory prior to flushing. On iOS changes are not synchronized between different preferences instances.

    Use Application.getPreferences(String) to look up a specific preferences instance. Note that on several backends the preferences name will be used as the filename, so make sure the name is valid for a filename.

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      void clear()  
      boolean contains​(java.lang.String key)  
      void flush()
      Makes sure the preferences are persisted.
      java.util.Map<java.lang.String,​?> get()
      Returns a read only Map with all the key, objects of the preferences.
      boolean getBoolean​(java.lang.String key)  
      boolean getBoolean​(java.lang.String key, boolean defValue)  
      float getFloat​(java.lang.String key)  
      float getFloat​(java.lang.String key, float defValue)  
      int getInteger​(java.lang.String key)  
      int getInteger​(java.lang.String key, int defValue)  
      long getLong​(java.lang.String key)  
      long getLong​(java.lang.String key, long defValue)  
      java.lang.String getString​(java.lang.String key)  
      java.lang.String getString​(java.lang.String key, java.lang.String defValue)  
      Preferences put​(java.util.Map<java.lang.String,​?> vals)  
      Preferences putBoolean​(java.lang.String key, boolean val)  
      Preferences putFloat​(java.lang.String key, float val)  
      Preferences putInteger​(java.lang.String key, int val)  
      Preferences putLong​(java.lang.String key, long val)  
      Preferences putString​(java.lang.String key, java.lang.String val)  
      void remove​(java.lang.String key)  
    • Method Detail

      • putBoolean

        Preferences putBoolean​(java.lang.String key,
                               boolean val)
      • putInteger

        Preferences putInteger​(java.lang.String key,
                               int val)
      • putLong

        Preferences putLong​(java.lang.String key,
                            long val)
      • putFloat

        Preferences putFloat​(java.lang.String key,
                             float val)
      • putString

        Preferences putString​(java.lang.String key,
                              java.lang.String val)
      • put

        Preferences put​(java.util.Map<java.lang.String,​?> vals)
      • getBoolean

        boolean getBoolean​(java.lang.String key)
      • getInteger

        int getInteger​(java.lang.String key)
      • getLong

        long getLong​(java.lang.String key)
      • getFloat

        float getFloat​(java.lang.String key)
      • getString

        java.lang.String getString​(java.lang.String key)
      • getBoolean

        boolean getBoolean​(java.lang.String key,
                           boolean defValue)
      • getInteger

        int getInteger​(java.lang.String key,
                       int defValue)
      • getLong

        long getLong​(java.lang.String key,
                     long defValue)
      • getFloat

        float getFloat​(java.lang.String key,
                       float defValue)
      • getString

        java.lang.String getString​(java.lang.String key,
                                   java.lang.String defValue)
      • get

        java.util.Map<java.lang.String,​?> get()
        Returns a read only Map with all the key, objects of the preferences.
      • contains

        boolean contains​(java.lang.String key)
      • clear

        void clear()
      • remove

        void remove​(java.lang.String key)
      • flush

        void flush()
        Makes sure the preferences are persisted.