Class MiscUtil

java.lang.Object
net.dv8tion.jda.api.utils.MiscUtil

public class MiscUtil extends Object
Utility methods for various aspects of the API.
  • Constructor Details

    • MiscUtil

      public MiscUtil()
  • Method Details

    • getShardForGuild

      public static int getShardForGuild(long guildId, int shards)
      Returns the shard id the given guild will be loaded on for the given amount of shards.

      Discord determines which guilds a shard is connect to using the following format: shardId == (guildId >>> 22) % totalShards
      Source for formula: Discord Documentation

      Parameters:
      guildId - The guild id.
      shards - The amount of shards.
      Returns:
      The shard id for the guild.
    • getShardForGuild

      public static int getShardForGuild(String guildId, int shards)
      Returns the shard id the given guild will be loaded on for the given amount of shards.

      Discord determines which guilds a shard is connect to using the following format: shardId == (guildId >>> 22) % totalShards
      Source for formula: Discord Documentation

      Parameters:
      guildId - The guild id.
      shards - The amount of shards.
      Returns:
      The shard id for the guild.
    • getShardForGuild

      public static int getShardForGuild(Guild guild, int shards)
      Returns the shard id the given Guild will be loaded on for the given amount of shards.

      Discord determines which guilds a shard is connect to using the following format: shardId == (guildId >>> 22) % totalShards
      Source for formula: Discord Documentation

      Parameters:
      guild - The guild.
      shards - The amount of shards.
      Returns:
      The shard id for the guild.
    • newLongMap

      @Nonnull public static <T> gnu.trove.map.TLongObjectMap<T> newLongMap()
      Generates a new thread-safe TLongObjectMap
      Type Parameters:
      T - The Object type
      Returns:
      a new thread-safe TLongObjectMap
    • parseLong

      public static long parseLong(String input)
    • parseSnowflake

      public static long parseSnowflake(String input)
    • locked

      @UnknownNullability public static <E> E locked(ReentrantLock lock, Supplier<E> task)
    • locked

      public static void locked(ReentrantLock lock, Runnable task)
    • tryLock

      public static void tryLock(Lock lock)
      Tries to acquire the provided lock in a 10 second timeframe.
      Parameters:
      lock - The lock to acquire
      Throws:
      IllegalStateException - If the lock could not be acquired
    • appendTo

      public static void appendTo(Formatter formatter, int width, int precision, boolean leftJustified, String out)
      Can be used to append a String to a formatter.
      Parameters:
      formatter - The Formatter
      width - Minimum width to meet, filled with space if needed
      precision - Maximum amount of characters to append
      leftJustified - Whether or not to left-justify the value
      out - The String to append