Interface CharObjectMap<V>

    • Method Detail

      • get

        V get​(char key)
        Retrieves the value associated with the key. If no mapping exists for the key, null is returned.
        Parameters:
        key - the key
        Returns:
        the value associated with the key, or the default value if no such mapping exists
      • getIfAbsent

        V getIfAbsent​(char key,
                      Function0<? extends V> ifAbsent)
        Retrieves the value associated with the key if one exists; if it does not, returns the result of invoking the value supplier.
        Parameters:
        key - the key
        function - the supplier that provides the value if no mapping exists for key
        Returns:
        the value associated with the key, if one exists, or the result of invoking ifAbsent if not
      • containsKey

        boolean containsKey​(char key)
        Returns whether or not the key is present in the map.
        Parameters:
        key - the key
        Returns:
        if a mapping exists in this map for the key
      • tap

        CharObjectMap<V> tap​(Procedure<? super V> procedure)
        Description copied from interface: RichIterable
        Executes the Procedure for each element in the iterable and returns this.

        Example using a Java 8 lambda expression:

         RichIterable<Person> tapped =
             people.tap(person -> LOGGER.info(person.getName()));
         

        Example using an anonymous inner class:

         RichIterable<Person> tapped =
             people.tap(new Procedure<Person>()
             {
                 public void value(Person person)
                 {
                     LOGGER.info(person.getName());
                 }
             });
         
        Specified by:
        tap in interface RichIterable<V>
        See Also:
        RichIterable.each(Procedure), RichIterable.forEach(Procedure)
      • forEachKey

        void forEachKey​(CharProcedure procedure)
        Iterates through each key in the map, invoking the procedure for each.
        Parameters:
        procedure - the procedure to invoke for each key
      • forEachKeyValue

        void forEachKeyValue​(CharObjectProcedure<? super V> procedure)
        Iterates through each key/value pair in the map, invoking the procedure for each.
        Parameters:
        procedure - the procedure to invoke for each key/value pair
      • injectIntoKeyValue

        default <IV> IV injectIntoKeyValue​(IV injectedValue,
                                           ObjectCharObjectToObjectFunction<? super IV,​? super V,​? extends IV> function)
        Implements the injectInto pattern with each key/value pair of the map.
        Parameters:
        value - to be injected into the map
        function - to apply to the injected value and key/value pairs
        Returns:
        result of injecting the injectedValue into the map
        Since:
        11.1
      • select

        CharObjectMap<V> select​(CharObjectPredicate<? super V> predicate)
        Return a copy of this map containing only the key/value pairs that match the predicate.
        Parameters:
        predicate - the predicate to determine which key/value pairs in this map should be included in the returned map
        Returns:
        a copy of this map with the matching key/value pairs
      • reject

        CharObjectMap<V> reject​(CharObjectPredicate<? super V> predicate)
        Return a copy of this map containing only the key/value pairs that do not match the predicate.
        Parameters:
        predicate - the predicate to determine which key/value pairs in this map should be excluded from the returned map
        Returns:
        a copy of this map without the matching key/value pairs
      • toImmutable

        ImmutableCharObjectMap<V> toImmutable()
        Returns a copy of this map that is immutable (if this map is mutable) or itself if it is already immutable.
        Returns:
        an immutable map that is equivalent to this one
      • keySet

        MutableCharSet keySet()
        Returns a set containing all the keys in this map. The set is backed by the map, so any modifications to the returned set will affect this map.
        Returns:
        a mutable set containing the keys in this map
      • keysView

        LazyCharIterable keysView()
        Returns a view of the keys in this map. This iterable is backed by the map, so any modifications to the underlying map will be reflected in the keys returned by the iterable.
        Returns:
        a view of the keys in this map
        Since:
        5.0
      • keyValuesView

        RichIterable<CharObjectPair<V>> keyValuesView()
        Returns a view of the key/value pairs in this map. This iterable is backed by the map, so any modifications to the underlying map will be reflected in the pairs returned by the iterable.
        Returns:
        a view of the keys in this map
        Since:
        5.0
      • flipUniqueValues

        ObjectCharMap<V> flipUniqueValues()
        Return the ObjectCharMap that is obtained by flipping the direction of this map and making the associations from value to key.
        Throws:
        java.lang.IllegalStateException - if the ObjectCharMap contains duplicate values.
        Since:
        9.0