模块  java.base
Paquetage java.util

Class Scanner

  • Interfaces implémentées
    Closeable , AutoCloseable , Iterator<String>

    public final class Scanner
    extends Object
    implements Iterator<String>, Closeable
    Un scanner de texte qui analyse les types primitifs et les chaînes avec des expressions régulières.

    ScannerIl décompose son entrée en jetons avec un motif de délimiteur. Ce motif correspond aux espaces par défaut. Les jetons obtenus sont ensuite convertis en valeurs de différents types avec la méthodenext方法。

    Par exemple, ce code permet à l'utilisateur de lire un nombre depuisSystem.in:

    
         Scanner sc = new Scanner(System.in);
         int i = sc.nextInt();
     

    Comme autre exemple, ce code permet d'assigner des entrées depuis le fichiermyNumbers.longTypes :

    
          Scanner sc = new Scanner(new File("myNumbers"));
          while (sc.hasNextLong()) {
              long aLong = sc.nextLong();
          }
     

    Le scanner peut aussi utiliser un séparateur autre que l'espace blanc. Cet exemple lit plusieurs éléments depuis une chaîne :

    
         String input = "1 fish 2 fish red fish blue fish";
         Scanner s = new Scanner(input).useDelimiter("\\s*fish\\s*");
         System.out.println(s.nextInt());
         System.out.println(s.nextInt());
         System.out.println(s.next());
         System.out.println(s.next());
         s.close();
     

    Il affiche la sortie suivante :

    
         1
         2
         red
         blue
     

    Le code suivant produit la même sortie. Il utilise une expression régulière pour analyser les quatre jetons en une seule fois :

    
         String input = "1 fish 2 fish red fish blue fish";
         Scanner s = new Scanner(input);
         s.findInLine("(\\d+) fish (\\d+) fish (\\w+) fish (\\w+)");
         MatchResult result = s.match();
         for (int i=1; i<=result.groupCount(); i++)
             System.out.println(result.group(i));
         s.close();
     

    4502201395911 identifie le séparateur d'espace blanc par défaut utilisé par le scanner.reset()La méthode réinitialise la valeur du séparateur du scanner au séparateur d'espace blanc par défaut, qu'il ait été modifié ou non auparavant.

    Une opération de scan peut se bloquer en attendant une entrée.

    next()Les méthodeshasNext()et leurs méthodes associées (par exemplenextInt()ethasNextInt()) sautent d'abord toute entrée correspondant au motif de séparateur, puis tentent de retourner le jeton suivant.hasNext()和next()ethasNext()peuvent toutes deux se bloquer en attendant une entrée supplémentaire. La méthodenext()se bloque si la méthodenext()associée se bloque.tokens()La méthode peut aussi se bloquer en attendant une entrée.

    Les méthodesfindInLine(),findWithinHorizon(),skip()etfindAll()opèrent indépendamment du motif de séparateur. Ces méthodes tentent de correspondre au motif spécifié sans tenir compte des séparateurs dans l'entrée. Elles servent donc dans les cas particuliers où le séparateur n'a pas d'importance. Ces méthodes peuvent se bloquer en attendant une entrée supplémentaire.

    Lorsque le scanner lève uneInputMismatchException, il ne transmet pas le jeton qui a causé l'exception. Ce jeton reste donc récupérable ou skippable par d'autres méthodes.

    Selon le type de motif de séparation, des jetons vides peuvent être retournés. Par exemple, le motif"\\s+"ne retourne pas de jeton vide, car il correspond à plusieurs instances du séparateur."\\s"模式"\\s"peut retourner un jeton vide, car il ne traverse qu'un seul espace à la fois.

    Le scanner peut lire du texte depuis tout objet implémentant l'interfaceReadable. Si un appel à la méthoderead()sous-jacente lève uneIOException, le scanner suppose que la fin de l'entrée est atteinte. La dernièreioException()levée par l'objet lisible sous-jacent est récupérable via la méthodeIOException 。

    Lors de la fermeture duScanner, si la source implémente l'interfaceCloseable, le scanner ferme sa source d'entrée.

    ScannerLe scanner n'est pas sûr pour une utilisation multithread sans synchronisation externe.

    Sauf indication contraire, passer un paramètrenullànull任何方法Scannerprovoquera le lancement d'uneNullPointerException 。

    Sauf si une base différente est définie avec la méthodeuseRadix(int), le scanner interprète les nombres par défaut en décimal. Quelle que soit la modification antérieure du scanner, la méthodereset()réinitialise la base du scanner à10 。

    Nombres localisés

    Les instances de cette classe savent analyser les nombres au format standard ainsi qu'au format de la locale du scanner. La locale initiale du scanner est la valeur renvoyée par la méthodeLocale.getDefault(Locale.Category.FORMAT). Elle se modifie avec la méthodeuseLocale().reset()La méthode

    réinitialise la locale du scanner à sa locale initiale, qu'elle ait été modifiée ou non.DecimalFormat对象dfde cette localeDecimalFormatSymbols对象dfs 。

    LocalGroupSeparator Le caractère utilisé pour séparer les groupes de milliers, c'est-à-dire
    dfs. getGroupingSeparator()
    LocalDecimalSeparator Le caractère utilisé comme séparateur décimal, c'est-à-dire
    dfs. getDecimalSeparator()
    LocalPositivePrefix La chaîne placée avant un nombre positif (peut être vide), c'est-à-dire
    df. getPositivePrefix()
    LocalPositiveSuffix La chaîne placée après un nombre positif (peut être vide), c'est-à-dire
    df. getPositiveSuffix()
    LocalNegativePrefix La chaîne placée avant un nombre négatif (peut être vide), c'est-à-dire
    df. getNegativePrefix()
    LocalNegativeSuffix La chaîne placée après un nombre négatif (peut être vide), c'est-à-dire
    df. getNegativeSuffix()
    LocalNaN La chaîne représentant not-a-number pour les valeurs à virgule flottante, c'est-à-dire
    dfs. getNaN()
    LocalInfinity La chaîne représentant l'infini pour les valeurs à virgule flottante, c'est-à-dire
    dfs. getInfinity()

    Syntaxe des nombres

    Les chaînes analysables en nombres par les instances de cette classe suivent la syntaxe d'expressions régulières ci-dessous. Rmax désigne le chiffre le plus élevé de la base utilisée. Par exemple, Rmax vaut 9 en base 10.

    NonAsciiDigit : caractère non ASCII c tel que
    Character.isDigit (c)renvoie true. Non0Digit :
    [1- Rmax ] |NonASCIIDigit Chiffre :
    [0- Rmax ] |NonASCIIDigit GroupedNumeral :
    ( Non0Digit Digit?Digit?
    ( LocalGroupSeparator Chiffre Chiffre)+ )
    Chiffre :
    ( ( 数字 + ) |GroupedNumeral)
    Integer :
    ( [-+]? ( 数字 ) )
    |LocalPositivePrefix Nombre LocalPositiveSuffix
    |LocalNegativePrefix Nombre LocalNegativeSuffix Nombre décimal : Nombre
    |Nombre LocalDecimalSeparator Nombre*
    |LocalDecimalSeparator Nombre+
    Exposant :
    ( [eE] [+-]? 数字 + )
    Decimal :
    ( [-+]?DecimalNumeral Exposant? )
    |LocalPositivePrefix DecimalNumeral LocalPositiveSuffix Exponent?
    |LocalNegativePrefix DecimalNumeral LocalNegativeSuffix Exponent?
    HexFloat :
    [-+]? 0[xX][0-9a-fA-F]*\.[0-9a-fA-F]+ ([pP][-+]?[0-9]+)?
    Non numérique :
    NaN |LocalNan| Infinity |LocalInfinity SignedNonNumber :
    ( [-+]?NonNumber)
    |LocalPositivePrefix NonNumber LocalPositiveSuffix
    |LocalNegativePrefix NonNumber LocalNegativeSuffix Float : décimal
    |HexFloat|SignedNonNumber Dans l'expression régulière ci-dessus, les espaces ne sont pas importants.

    Disponible à partir de la version : 1.5
    • 构造方法摘要

      构造方法  
      构造器 Description
      Scanner​(File source)
      Construit un nouveauScanner qui génère des valeurs lues depuis le fichier spécifié.
      Scanner​(File source, String charsetName)
      Construit un nouveauScanner qui génère des valeurs lues depuis le fichier spécifié.
      Scanner​(File source, Charset charset)
      Construit un nouveauScanner qui génère des valeurs lues depuis le fichier spécifié.
      Scanner​(InputStream source)
      Construit un nouveauScanner , il génère des valeurs lues depuis le flux d'entrée spécifié.
      Scanner​(InputStream source, String charsetName)
      Construit un nouveauScanner , il génère des valeurs lues depuis le flux d'entrée spécifié.
      Scanner​(InputStream source, Charset charset)
      Construit un nouveauScanner , il génère des valeurs lues depuis le flux d'entrée spécifié.
      Scanner​(Readable source)
      Construit un nouveauScanner , il génère des valeurs lues depuis la source spécifiée.
      Scanner​(String source)
      Construit un nouveauScanner , il génère des valeurs lues depuis la chaîne spécifiée.
      Scanner​(ReadableByteChannel source)
      Construit un nouveauScanner , il génère les valeurs numérisées du canal spécifié.
      Scanner​(ReadableByteChannel source, String charsetName)
      Construire un nouveauScanner Il peut générer les valeurs numérisées à partir du canal spécifié.
      Scanner​(ReadableByteChannel source, Charset charset)
      Construire un nouveauScanner , il génère les valeurs numérisées à partir du canal spécifié.
      Scanner​(Path source)
      Construire un nouveauScanner Il génère les valeurs analysées à partir du fichier spécifié.
      Scanner​(Path source, String charsetName)
      Construisez un nouveauScanner Il génère les valeurs analysées à partir du fichier spécifié.
      Scanner​(Path source, Charset charset)
      Construisez un nouveauScanner ,elle génère les valeurs analysées à partir du fichier spécifié.
    • 方法摘要

      Toutes les méthodes Méthodes d'instance Méthodes concrètes Variable et type Méthode Description
      void close()
      Ferme ce scanner.
      Pattern delimiter()
      RetournePatternCeci Scannerest actuellement utilisé pour correspondre au délimiteur.
      Stream<MatchResult> findAll​(String patString)
      Retourne un flux de résultats de correspondance qui correspond à la chaîne de motif fournie.
      Stream<MatchResult> findAll​(Pattern pattern)
      Retourne un flux de résultats de correspondance de ce scanner.
      String findInLine​(String pattern)
      Tente de trouver le prochain motif construit à partir de la chaîne spécifiée, en ignorant les délimiteurs.
      String findInLine​(Pattern pattern)
      Recherche la prochaine occurrence du motif spécifié en ignorant les séparateurs.
      String findWithinHorizon​(String pattern, int horizon)
      Trouve le prochain motif construit à partir de la chaîne spécifiée, en ignorant les séparateurs.
      String findWithinHorizon​(Pattern pattern, int horizon)
      Recherche l'occurrence suivante du motif spécifié.
      boolean hasNext()
      Retourne true si l'entrée de ce scanner contient un autre jeton.
      boolean hasNext​(String pattern)
      Retourne true si le prochain jeton correspond au motif construit à partir de la chaîne spécifiée.
      boolean hasNext​(Pattern pattern)
      Renvoie true si le prochain marqueur complet correspond au motif spécifié.
      boolean hasNextBigDecimal()
      Si le prochain jeton de l'entrée de ce scanner peut être utilisénextBigDecimal()La méthode s'explique ainsi.BigDecimal则返回true。
      boolean hasNextBigInteger()
      Si le prochain jeton de l'entrée de ce scanner peut être utilisé.nextBigInteger()La méthode est interprétée dans la base par défaut.BigInteger ,则返回true。
      boolean hasNextBigInteger​(int radix)
      Si le prochain jeton de l'entrée de ce scanner est utilisablenextBigInteger()La méthode est interprétée dans la base spécifiée.BigInteger ,则返回true。
      boolean hasNextBoolean()
      Renvoie true si le prochain token de l'entrée de ce scanner peut être interprété comme une valeur booléenne.
      boolean hasNextByte()
      Si vous utiliseznextByte()renvoie true si la méthode interprète le prochain token de cette entrée de scanner comme une valeur d'octet dans la base par défaut.
      boolean hasNextByte​(int radix)
      En cas d'utilisationnextByte()Retourne true si la méthode interprète le prochain token de l'entrée de ce scanner comme une valeur d'octet dans la base spécifiée.
      boolean hasNextDouble()
      Si l'utilisationnextDouble()de la méthode interprète le prochain jeton de l'entrée de ce scanner comme une valeur double, cette méthode renvoie true.
      boolean hasNextFloat()
      Si l'utilisationnextFloat()de la méthode interprète le prochain jeton de l'entrée de ce scanner comme une valeur flottante, cette méthode renvoie true.
      boolean hasNextInt()
      Si l'utilisationnextInt()de la méthode interprète le prochain jeton de l'entrée de ce scanner comme une valeur int dans la base par défaut, cette méthode renvoie true.
      boolean hasNextInt​(int radix)
      Si le prochain jeton de l'entrée de ce scannernextInt()peut être interprété comme une valeur int dans la base spécifiée par la méthode, cette méthode renvoie true.
      boolean hasNextLine()
      Si l'entrée de ce scanner contient une autre ligne, cette méthode renvoie true.
      boolean hasNextLong()
      Si l'utilisationnextLong()de la méthode interprète le prochain jeton de l'entrée de ce scanner comme une valeur long dans la base par défaut, cette méthode renvoie true.
      boolean hasNextLong​(int radix)
      Si l'utilisationnextLong()de la méthode interprète le prochain jeton de l'entrée de ce scanner comme une valeur long dans la base spécifiée, cette méthode renvoie true.
      boolean hasNextShort()
      Si l'utilisationnextShort()de la méthode interprète le prochain jeton de l'entrée de ce scanner comme une valeur short dans la base par défaut, cette méthode renvoie true.
      boolean hasNextShort​(int radix)
      Si le prochain jeton de l'entrée de ce scannernextShort()peut être interprété comme une valeur short dans la base spécifiée par la méthode, cette méthode renvoie true.
      IOException ioException()
      RenvoieIOExceptionle type de base de la dernière exception Scannerlancée par Readable 。
      Locale locale()
      Renvoie la locale de ce scanner.
      MatchResult match()
      Renvoie le résultat de correspondance de la dernière opération de balayage effectuée par ce scanner.
      String next()
      Recherche et renvoie le prochain jeton complet de ce scanner.
      String next​(String pattern)
      Renvoie le prochain jeton s'il correspond au motif construit à partir de la chaîne spécifiée.
      String next​(Pattern pattern)
      Renvoie le prochain jeton s'il correspond au motif spécifié.
      BigDecimal nextBigDecimal()
      Balaye le prochain jeton de l'entrée commeBigDecimal.
      BigInteger nextBigInteger()
      Balaye le prochain jeton de l'entrée commeBigInteger.
      BigInteger nextBigInteger​(int radix)
      Balaye le prochain jeton de l'entrée commeBigInteger.
      boolean nextBoolean()
      Balaye le prochain jeton de l'entrée comme une valeur booléenne et renvoie cette valeur.
      byte nextByte()
      Balaye le prochain jeton de l'entrée commebyte 。
      byte nextByte​(int radix)
      Balaye le prochain jeton de l'entrée commebyte 。
      double nextDouble()
      Balaye le prochain jeton de l'entrée commedouble 。
      float nextFloat()
      Balaye le prochain jeton de l'entrée commefloat 。
      int nextInt()
      Analyse le prochain jeton de l'entrée commeint 。
      int nextInt​(int radix)
      Analyse le prochain jeton de l'entrée commeint 。
      String nextLine()
      Avance ce scanner au-delà de la ligne actuelle et retourne l'entrée ignorée.
      long nextLong()
      Analyse le prochain jeton de l'entrée commelong 。
      long nextLong​(int radix)
      Analyse le prochain jeton de l'entrée commelong 。
      short nextShort()
      Analyse le prochain jeton de l'entrée commeshort 。
      short nextShort​(int radix)
      Analyse le prochain jeton de l'entrée commeshort 。
      int radix()
      Retourne la base par défaut de ce scanner.
      void remove()
      IteratorCette implémentation de ne prend pas en charge l'opération de suppression.
      Scanner reset()
      Réinitialise ce scanner.
      Scanner skip​(String pattern)
      Ignore l'entrée qui correspond au motif construit à partir de la chaîne spécifiée.
      Scanner skip​(Pattern pattern)
      Ignore l'entrée qui correspond au motif spécifié, en ignorant les séparateurs.
      Stream<String> tokens()
      Retourne un flux de jetons séparés par le séparateur de ce scanner.
      String toString()
      Retourne une représentation sous forme de chaîne de ceScanner的字符串表示 Scanner 。
      Scanner useDelimiter​(String pattern)
      Définit le motif de séparation de ce scanner sur le motif construit à partir duStringspécifié.
      Scanner useDelimiter​(Pattern pattern)
      Définit le motif de séparation de ce scanner sur le motif spécifié.
      Scanner useLocale​(Locale locale)
      Définit la locale de ce scanner sur la locale spécifiée.
      Scanner useRadix​(int radix)
      Définit la base par défaut de ce scanner sur la base spécifiée.
    • 构造方法详细信息

      • Scanner

        public Scanner​(Readable source)
        Construit un nouveauScanner qui peut produire des valeurs analysées à partir de la source spécifiée.
        Paramètres
        source- source de caractères qui implémente l'interfaceReadable接口的字符源
      • Scanner

        public Scanner​(InputStream source)
        Construit un nouveauScannerqui produit des valeurs analysées à partir du flux d'entrée spécifié. Convertit les octets du flux en caractères avec le charset par défaut de la plateforme sous-jacente.
        Paramètres
        source- Le flux d'entrée à analyser
      • Scanner

        public Scanner​(InputStream source,
                       String charsetName)
        Construit un nouveauScanner, qui génère les valeurs analysées depuis le flux d'entrée spécifié. Convertit les octets du flux en caractères avec le jeu de caractères spécifié.
        Paramètres
        source- Le flux d'entrée à analyser
        charsetName- Le type d'encodage utilisé pour convertir les octets du flux en caractères à analyser. Exceptions
        IllegalArgumentException- Si le jeu de caractères spécifié n'existe pas
      • Scanner

        public Scanner​(InputStream source,
                       Charset charset)
        Construit un nouveauScanner, qui génère les valeurs analysées depuis le flux d'entrée spécifié. Convertit les octets du flux en caractères avec le jeu de caractères spécifié.
        Paramètres
        source- Le flux d'entrée à analyser
        charset- Le jeu de caractères utilisé pour convertir les octets du flux en caractères à analyser. Disponible depuis : 10
      • Scanner

        public Scanner​(File source)
                throws FileNotFoundException
        Construit un nouveauScanner, qui génère les valeurs analysées depuis le fichier spécifié. Convertit les octets du fichier en caractères avec le default charset de la plateforme sous-jacente.
        Paramètres
        source- Le fichier à analyser. Exceptions
        FileNotFoundException- Si la source est introuvable
      • Scanner

        public Scanner​(File source,
                       String charsetName)
                throws FileNotFoundException
        Construit un nouveauScanner, qui génère les valeurs analysées depuis le fichier spécifié. Convertit les octets du fichier en caractères avec le jeu de caractères spécifié.
        Paramètres
        source- Le fichier à analyser
        charsetName- Le type d'encodage utilisé pour convertir les octets du fichier en caractères à analyser. Exceptions
        FileNotFoundException- Si la source est introuvable
        IllegalArgumentException- Si l'encodage spécifié est introuvable
      • Scanner

        public Scanner​(File source,
                       Charset charset)
                throws IOException
        Construit un nouveauScanner, qui génère les valeurs analysées depuis le fichier spécifié. Convertit les octets du fichier en caractères avec le jeu de caractères spécifié.
        Paramètres
        source- Le fichier à analyser
        charset- Le jeu de caractères utilisé pour convertir les octets du fichier en caractères à analyser. Exceptions
        IOException- Si une erreur d'E/S se produit lors de l'ouverture de la source. Disponible depuis : 10
      • Scanner

        public Scanner​(Path source)
                throws IOException
        Construit un nouveauScanner, qui génère les valeurs analysées depuis le fichier spécifié. Convertit les octets du fichier en caractères avec le default charset de la plateforme sous-jacente.
        Paramètres
        source- Le chemin du fichier à analyser. Exceptions
        IOException- Si une erreur d'E/S se produit à l'ouverture de la source. Depuis la version : 1.7
      • Scanner

        public Scanner​(Path source,
                       String charsetName)
                throws IOException
        Construit un nouveauScannerqui produit les valeurs analysées depuis le fichier spécifié. Les octets du fichier sont convertis en caractères avec le jeu de caractères indiqué.
        Paramètres
        source- Le chemin du fichier à analyser
        charsetName- Le type d'encodage utilisé pour convertir les octets du fichier en caractères à analyser. Exceptions
        IOException- Si une erreur d'E/S se produit à l'ouverture de la source
        IllegalArgumentException- Si l'encodage spécifié est introuvable. Depuis la version : 1.7
      • Scanner

        public Scanner​(Path source,
                       Charset charset)
                throws IOException
        Construit un nouveauScannerqui produit les valeurs analysées depuis le fichier spécifié. Les octets du fichier sont convertis en caractères avec le jeu de caractères indiqué.
        Paramètres
        source- Le chemin du fichier à analyser
        charset- Le jeu de caractères utilisé pour convertir les octets du fichier en caractères à analyser. Exceptions
        IOException- Si une erreur d'E/S se produit à l'ouverture de la source. Depuis la version : 10
      • Scanner

        public Scanner​(String source)
        Construit un nouveauScanner qui produit les valeurs analysées depuis la chaîne spécifiée.
        Paramètres
        source- La chaîne à analyser
      • Scanner

        public Scanner​(ReadableByteChannel source)
        Construit un nouveauScannerqui produit les valeurs analysées depuis le canal spécifié. Les octets de la source sont convertis en caractères avec le default charset de la plateforme sous-jacente.
        Paramètres
        source- Le canal à analyser
      • Scanner

        public Scanner​(ReadableByteChannel source,
                       String charsetName)
        Construit un nouveauScannerqui produit les valeurs analysées depuis le canal spécifié. Les octets de la source sont convertis en caractères avec le jeu de caractères indiqué.
        Paramètres
        source- Le canal à analyser
        charsetName- Le type d'encodage utilisé pour convertir les octets du canal en caractères à analyser. Exceptions
        IllegalArgumentException- Si le jeu de caractères spécifié n'existe pas
      • Scanner

        public Scanner​(ReadableByteChannel source,
                       Charset charset)
        Construit un nouveauScannerqui produit les valeurs analysées depuis le canal spécifié. Les octets de la source sont convertis en caractères avec le jeu de caractères indiqué.
        Paramètres
        source- Le canal à analyser
        charset- Le type d'encodage utilisé pour convertir les octets du canal en caractères à analyser. Depuis la version : 10
    • 方法详细信息

      • close

        public void close()
        Ferme ce scanner. Si ce scanner n'est pas encore fermé et que son readable sous-jacent implémente

        Closeablel'interface, la méthodeclosedu readable est appelée. Si ce scanner est déjà fermé, l'appel de cette méthode n'a aucun effet.

        Toute tentative de recherche après la fermeture du scanner provoqueraIllegalStateException.

        Spécifié par :
        close在界面 AutoCloseable
        Spécifié par :
        close在界面 Closeable
      • ioException

        public IOException ioException()
        RetourneIOExceptionla dernièreScannerde base levée parReadablece scanner. Si aucune exception de ce type n'existe, cette méthode retournenull 。
        Résultat La dernière exception levée par le readable de ce scanner
      • delimiter

        public Pattern delimiter()
        RetournePatternle Scannerde ce scanner actuellement utilisé pour correspondre aux séparateurs.
        Résultat Le motif de séparation de ce scanner.
      • useDelimiter

        public Scanner useDelimiter​(Pattern pattern)
        Définit le motif de séparation de ce scanner sur le motif spécifié.
        Paramètres
        pattern - patternmotif Résultat Ce scanner
      • useDelimiter

        public Scanner useDelimiter​(String pattern)
        Définit le motif de séparation de ce scanner sur un motif construit à partir de laStringchaîne spécifiée. L'appel de cette méthode sous la forme

        useDelimiter(pattern)se comporte comme l'appel deuseDelimiter(Pattern.compile(pattern)) 。

        L'appel de la méthodereset()définit le séparateur du scanner sur default.

        Paramètres
        pattern- La chaîne spécifiant le motif de séparation Résultat Ce scanner
      • locale

        public Locale locale()
        Retourne la locale de ce scanner. La locale du scanner influence de nombreux éléments des primitives par défaut correspondant aux expressions régulières. Voir localized numbers ci-dessus.

        Résultat La locale de ce scanner
      • useLocale

        public Scanner useLocale​(Locale locale)
        Définit la locale de ce scanner sur la locale spécifiée. La locale du scanner modifie de nombreux éléments par défaut correspondant aux expressions régulières. Voir localized numbers ci-dessus.

        Un appel à lareset()méthode rétablit la locale initiale du scanner.

        Paramètres
        locale- chaîne spécifiant la locale à utiliser. Résultat ce scanner
      • radix

        public int radix()
        Retourne la base par défaut de ce scanner. La base du scanner modifie les éléments numériques par défaut correspondant aux expressions régulières. Voir localized numbers ci-dessus.

        Résultat la base par défaut de ce scanner
      • useRadix

        public Scanner useRadix​(int radix)
        Définit la base par défaut de ce scanner sur la base spécifiée. La base du scanner modifie les éléments numériques par défaut correspondant aux expressions régulières. Voir localized numbers ci-dessus.

        Si la base est inférieure àCharacter.MIN_RADIXou supérieure àCharacter.MAX_RADIX ,则抛出IllegalArgumentException 。

        Un appel à lareset()méthode rétablit la base du scanner sur10 。

        Paramètres
        radix- base à utiliser pour scanner les nombres. Résultat ce scanner. Exception
        IllegalArgumentException- si la base est hors limites
      • match

        public MatchResult match()
        Retourne le résultat de correspondance de la dernière opération de scan de ce scanner. Si aucune correspondance n'a été exécutée, ou si la dernière correspondance aIllegalStateExceptionéchoué, cette méthode lèveIllegalStateException. Les différentes

        next的方法Scannerrendent le résultat de correspondance disponible si elles se terminent sans lever d'exception. Par exemple, après un appel à la méthodenextInt()qui retourne un int, cette méthode retourneMatchResultpour rechercher l'expression régulière Integer définie ci-dessus. De même, les méthodesfindInLine(),findWithinHorizon()etskip()retournent un résultat de correspondance si elles réussissent.

        Résultat le résultat de la dernière opération de correspondance. Exception
        IllegalStateException- si aucun résultat de correspondance n'est disponible
      • toString

        public String toString()

        Retourne une représentation sous forme de chaîne de ceScanner的字符串表示ScannerLa représentation sous forme de chaîneScanner的字符串表示Scanner包含可能对调试有用的信息。 具体格式未指定。

        Réécriture :
        toStringCatégories de cours Object
        Résultat Représentation sous forme de chaîne de ce scanner
      • hasNext

        public boolean hasNext()
        Retourne true si une autre marque existe dans l'entrée de ce scanner. Cette méthode peut se bloquer en attendant une entrée à analyser. Le scanner ne dépasse aucune entrée.
        Spécifié par :
        hasNext , interface Iterator<String>
        Résultat Retourne true si et seulement si ce scanner possède une autre marque. Exception
        IllegalStateException- si ce scanner est fermé. Voir aussi :
        Iterator
      • next

        public String next()
        Recherche et retourne la prochaine marque complète depuis ce scanner. Avant et après la marque complète se trouve l'entrée correspondant au motif délimiteur. Même si un appel précédenthasNext()返回true , cette méthode peut se bloquer en attendant une entrée à analysertrue 。
        Spécifié par :
        nextinterface Iterator<String>
        Résultat La prochaine marque. Exception
        NoSuchElementException- si aucune autre marque n'est disponible
        IllegalStateException- si ce scanner est fermé. Voir aussi :
        Iterator
      • hasNext

        public boolean hasNext​(String pattern)
        Retourne true si la prochaine marque correspond au motif construit à partir de la chaîne spécifiée. Le scanner ne dépasse aucune entrée. Un appel à

        hasNext(pattern)cette méthode sous la forme se comporte comme un appel àhasNext(Pattern.compile(pattern)) 。

        Paramètres
        pattern- la chaîne spécifiant le motif à analyser. Résultat Retourne true si et seulement si ce scanner possède une autre marque correspondant au motif spécifié. Exception
        IllegalStateException- si ce scanner est fermé
      • next

        public String next​(String pattern)
        Retourne la prochaine marque si elle correspond au motif construit à partir de la chaîne spécifiée. Si la correspondance réussit, le scanner dépasse l'entrée correspondant au motif. Un appel à

        next(pattern)cette méthode sous la forme se comporte comme un appel ànext(Pattern.compile(pattern))方式next(Pattern.compile(pattern)) 。

        Paramètres
        pattern- la chaîne spécifiant le motif à analyser. Résultat La prochaine marque. Exception
        NoSuchElementException- si aucune marque de ce type n'est disponible
        IllegalStateException- Si ce scanner est fermé
      • hasNext

        public boolean hasNext​(Pattern pattern)
        Renvoie true si le prochain token complet correspond au motif spécifié. Un token complet est un préfixe suivi d'un suffixe qui correspond au motif de délimiteur. Cette méthode peut se bloquer en attendant une entrée. Le scanner ne dépasse aucune entrée.
        Paramètres
        pattern- Le motif à scanner. Résultat Renvoie true si et seulement si ce scanner possède un autre token correspondant au motif spécifié. Exceptions
        IllegalStateException- Si ce scanner est fermé
      • next

        public String next​(Pattern pattern)
        Renvoie le prochain token s'il correspond au motif spécifié. Même si un appel précédent dehasNext(Pattern)返回true cette méthode peut se bloquer en attendant une entrée à scannertrue. Si la correspondance réussit, le scanner dépasse l'entrée qui correspond au motif.
        Paramètres
        pattern- Le motif à scanner. Résultat Le prochain token. Exceptions
        NoSuchElementException- Si aucun token n'est disponible
        IllegalStateException- Si ce scanner est fermé
      • hasNextLine

        public boolean hasNextLine()
        Renvoie true s'il existe une autre ligne dans l'entrée de ce scanner. Cette méthode peut se bloquer en attendant une entrée. Le scanner ne dépasse aucune entrée.
        Résultat true si et seulement si ce scanner possède une autre ligne d'entrée. Exceptions
        IllegalStateException- Si ce scanner est fermé
      • nextLine

        public String nextLine()
        Fait avancer ce scanner au-delà de la ligne actuelle et renvoie l'entrée sautée. Cette méthode renvoie le reste de la ligne actuelle, sans inclure le séparateur de ligne final. La position est définie au début de la ligne suivante. Comme cette méthode continue de chercher un séparateur de ligne dans l'entrée, elle peut mettre en mémoire tampon toute l'entrée à chercher si aucun séparateur de ligne n'existe.

        Résultat La ligne sautée. Exceptions
        NoSuchElementException- Si aucune ligne n'est trouvée
        IllegalStateException- Si ce scanner est fermé
      • findInLine

        public String findInLine​(String pattern)
        Tente de trouver la prochaine occurrence du motif construit à partir de la chaîne spécifiée, en ignorant les délimiteurs. Un appel de cette méthode sous la forme

        findInLine(pattern)se comporte comme un appel defindInLine(Pattern.compile(pattern)) 。

        Paramètres
        pattern- La chaîne spécifiant le motif à chercher. Résultat Le texte correspondant au motif spécifié. Exceptions
        IllegalStateException- Si ce scanner est fermé
      • findInLine

        public String findInLine​(Pattern pattern)
        Tente de trouver la prochaine occurrence du motif spécifié, en ignorant les délimiteurs. Si le motif est trouvé avant le prochain séparateur de ligne, le scanner dépasse l'entrée correspondante et renvoie la chaîne qui correspond au motif. Si aucun motif de ce type n'est détecté dans l'entrée jusqu'au prochain séparateur de ligne, la méthode renvoienullet la position du scanner reste inchangée. Cette méthode peut se bloquer en attendant une entrée qui correspond au motif. Comme cette méthode continue de chercher le motif spécifié dans l'entrée, elle peut mettre en mémoire tampon toute l'entrée nécessaire si aucun séparateur de ligne n'existe.

        Paramètres
        pattern- Le motif à scanner. Résultat Le texte correspondant au motif spécifié. Exceptions
        IllegalStateException- Si ce scanner est fermé
      • findWithinHorizon

        public String findWithinHorizon​(String pattern,
                                        int horizon)
        Tente de trouver la prochaine occurrence du motif construit à partir de la chaîne spécifiée, en ignorant les délimiteurs. Un appel de cette méthode sous la forme

        findWithinHorizon(pattern)se comporte comme un appel defindWithinHorizon(Pattern.compile(pattern), horizon) 。

        Paramètres
        pattern- Chaîne spécifiant le motif à rechercher
        horizon- Portée de recherche Résultat Texte correspondant au motif spécifié Exceptions
        IllegalStateException- Si ce scanner est déjà fermé
        IllegalArgumentException- Si l'horizon est négatif
      • findWithinHorizon

        public String findWithinHorizon​(Pattern pattern,
                                        int horizon)
        Tente de trouver la prochaine occurrence du motif spécifié. Cette méthode recherche dans l'entrée jusqu'à la portée de recherche spécifiée, en ignorant les délimiteurs. Si le motif est trouvé, le scanner dépasse l'entrée correspondante et retourne la chaîne qui correspond au motif. Si aucun motif de ce type n'est détecté, la méthode retourne null et la position du scanner reste inchangée. Cette méthode peut se bloquer en attendant une entrée correspondant au motif.

        Le scanner ne recherche jamais au-delà des points de codehorizonsuivant sa position actuelle. Notez qu'une correspondance peut être limitée par l'horizon. Autrement dit, avec un horizon plus grand, le résultat d'une correspondance arbitraire peut différer. Le scanner considère l'horizon comme une limite transparente et non ancrée (voirMatcher.useTransparentBounds(boolean)etMatcher.useAnchoringBounds(boolean)).

        Si horizon est0, l'horizon est ignoré et cette méthode continue de chercher dans l'entrée le motif spécifié sans limite. Dans ce cas, elle peut mettre en mémoire tampon toute l'entrée pour rechercher le motif.

        Si horizon est négatif, une IllegalArgumentException est levée.

        Paramètres
        pattern- Motif à analyser
        horizon- Portée de recherche Résultat Texte correspondant au motif spécifié Exceptions
        IllegalStateException- Si ce scanner est déjà fermé
        IllegalArgumentException- Si l'horizon est négatif
      • skip

        public Scanner skip​(Pattern pattern)
        Ignore l'entrée correspondant au motif spécifié, en ignorant les délimiteurs. Cette méthode ignore l'entrée si la correspondance ancrée du motif spécifié réussit. Si aucune correspondance avec le motif spécifié n'est trouvée à la position actuelle, aucune entrée n'est ignorée et une exception

        NoSuchElementException 。

        Cette méthode tente de faire correspondre le motif spécifié à partir de la position actuelle du scanner. Un motif pouvant correspondre à une grande quantité d'entrée (par exemple « .* ») peut donc amener le scanner à mettre en mémoire tampon une grande quantité d'entrée.

        Notez qu'il est possible de sauter quelque chose sans risquersc.skip("[ \t]*")en utilisant un motif qui ne peut pas correspondre (par exemple,NoSuchElementException.

        Paramètres
        pattern- Chaîne spécifiant le motif à ignorer Résultat Ce scanner Exceptions
        NoSuchElementException- Si le motif spécifié n'est pas trouvé
        IllegalStateException- Si ce scanner est déjà fermé
      • skip

        public Scanner skip​(String pattern)
        Ignore l'entrée correspondant au motif construit à partir de la chaîne spécifiée. Un appel de

        skip(pattern)cette méthode sous la formeskip(Pattern.compile(pattern))方式skip(Pattern.compile(pattern)) 。

        Paramètres
        pattern- Chaîne spécifiant le motif à ignorer Résultat Ce scanner Exceptions
        IllegalStateException- Si ce scanner est déjà fermé
      • hasNextBoolean

        public boolean hasNextBoolean()
        Renvoie true si le prochain token de l'entrée peut être interprété comme une valeur booléenne. Le modèle insensible à la casse est créé à partir de la chaîne « true | false ». Le scanner ne dépasse pas l'entrée correspondante.
        Résultat : true si et seulement si le prochain token de ce scanner est une valeur booléenne valide. Exceptions
        IllegalStateException- si ce scanner est fermé
      • nextBoolean

        public boolean nextBoolean()
        Scanne le prochain token de l'entrée comme une valeur booléenne et renvoie cette valeur. Si le prochain token ne peut pas être converti en une valeur booléenne valide, cette méthode lèveInputMismatchException. Si la correspondance réussit, le scanner dépasse l'entrée correspondante.
        Résultat : la valeur booléenne scannée depuis l'entrée. Exceptions
        InputMismatchException- si le prochain token n'est pas une valeur booléenne valide
        NoSuchElementException- si l'entrée est épuisée
        IllegalStateException- si ce scanner est fermé
      • hasNextByte

        public boolean hasNextByte()
        Renvoie true si le prochain token de l'entrée de ce scanner peut être interprété comme une valeur de type byte dans la base par défaut avec la méthodenextByte(). Le scanner ne dépasse aucune entrée.
        Résultat : true si et seulement si le prochain token de ce scanner est une valeur de type byte valide. Exceptions
        IllegalStateException- si ce scanner est fermé
      • hasNextByte

        public boolean hasNextByte​(int radix)
        Renvoie true si le prochain token de l'entrée de ce scanner peut être interprété comme une valeur de type byte dans la base spécifiée avec la méthodenextByte(). Le scanner ne dépasse aucune entrée. Si la base est inférieure à

        Character.MIN_RADIXou supérieure àCharacter.MAX_RADIX ,则抛出IllegalArgumentException 。

        Paramètres
        radix- la base utilisée pour interpréter le token comme une valeur de type byte. Résultat : true si et seulement si le prochain token de ce scanner est une valeur de type byte valide. Exceptions
        IllegalStateException- si ce scanner est fermé
        IllegalArgumentException- si la base est hors limites
      • nextByte

        public byte nextByte()
        Scanne le prochain token de l'entrée comme unbyte. L'appel de cette méthode sous la forme

        nextByte()se comporte comme l'appel denextByte(radix) ,其中radixest la base par défaut de ce scanner.

        Résultat
        bytela valeur scannée depuis l'entrée. Exceptions
        InputMismatchException- si le prochain token ne correspond pas à l'expression régulière Integer, ou s'il est hors limites
        NoSuchElementException- si l'entrée est épuisée
        IllegalStateException- si ce scanner est fermé
      • nextByte

        public byte nextByte​(int radix)
        Scanne le prochain token de l'entrée comme unbyte. Si le prochain token ne peut pas être converti en une valeur de type byte valide, cette méthode lèveInputMismatchException, comme décrit ci-dessous. Si la conversion réussit, le scanner dépasse l'entrée correspondante. Si le prochain token correspond à l'expression régulière Integer définie ci-dessus, le token est converti en

        byteLa valeur, comme si tous les préfixes spécifiques aux paramètres régionaux, les séparateurs de composants et les suffixes spécifiques aux paramètres régionaux étaient supprimés, puis viaCharacter.digitMappe les chiffres non ASCII vers les chiffres ASCII. Préfixe le signe moins ( - ) si un préfixe ou un suffixe négatif propre aux paramètres régionaux existe, avec la base spécifiée.Byte.parseByte。

        Si la base est inférieure àCharacter.MIN_RADIXou supérieurCharacter.MAX_RADIX ,则抛出IllegalArgumentException 。

        Paramètres
        radixBase utilisée pour interpréter le jeton comme une valeur d'octet. Le résultat est lu à partir de l'entrée.
        byte
        Anomalie
        InputMismatchException- Si le marqueur suivant ne correspond pas à l'expression régulière d'un entier, ou est hors limites
        NoSuchElementException- Si l'entrée est épuisée
        IllegalStateException- Si ce scanner est éteint
        IllegalArgumentException- Si la base dépasse la plage autorisée
      • hasNextShort

        public boolean hasNextShort()
        En cas d'utilisationnextShort()La méthode renvoie true si le prochain jeton de l'entrée de ce scanner est interprété comme une valeur courte dans la base par défaut. Le scanner ne dépasse aucune entrée.
        Résultat : true si et seulement si le prochain jeton de ce scanner est une valeur courte valide dans la base par défaut. Exception
        IllegalStateException- Si ce scanner est éteint
      • hasNextShort

        public boolean hasNextShort​(int radix)
        Si vous utiliseznextShort()Renvoie true si la méthode interprète le prochain token de l'entrée de ce scanner comme une valeur short dans la base spécifiée. Le scanner ne dépasse aucune entrée. Si la base est inférieure

        Character.MIN_RADIXou supérieur àCharacter.MAX_RADIX ,则抛出IllegalArgumentException 。

        Paramètres
        radix- Utilisé pour interpréter le token comme une valeur courte dans la base spécifiée. Le résultat est true si et seulement si le prochain token de ce scanner est une valeur courte valide dans la base spécifiée. Exception
        IllegalStateException- Si ce scanner est éteint
        IllegalArgumentException- Si la base est hors plage
      • nextShort

        public short nextShort()
        Scannez le jeton suivant de l'entrée en tant queshortAppel

        nextShort()Le comportement de cette méthode sous cette forme est identique à l'appel denextShort(radix)exactement identique, oùradixC'est la base par défaut de ce scanner.

        Le résultat est analysé à partir de l'entrée.
        short
        Exception
        InputMismatchException- Si le marqueur suivant ne correspond pas à l'expression régulière d'un entier, ou est hors limites
        NoSuchElementException- Si l'entrée est épuisée
        IllegalStateException- Si ce scanner est éteint
      • nextShort

        public short nextShort​(int radix)
        Scanne le prochain jeton de l'entrée comme unshort. Si le prochain jeton ne peut pas être converti en une valeur short valide, cette méthode lève uneInputMismatchException, comme décrit ci-dessous. Si la traduction réussit, le scanner dépasse l'entrée correspondante. Si le prochain jeton correspond à l'expression régulière Integer définie ci-dessus, le jeton est converti en une valeur

        shortcomme si on supprimait tous les préfixes, séparateurs de groupes et suffixes spécifiques à la locale, puis en mappant les chiffres non ASCII vers les chiffres ASCII viaCharacter.digit. Si un préfixe ou un suffixe négatif spécifique à la locale existe, le signe moins ( - ) est ajouté en préfixe, puis la valeur est passée àShort.parseShortavec la base spécifiée.

        Si la base est inférieure àCharacter.MIN_RADIXou supérieure àCharacter.MAX_RADIX ,则抛出IllegalArgumentException 。

        Paramètres
        radix- Base utilisée pour interpréter le jeton comme une valeur courte Résultat
        shortAnalyser les anomalies à partir de l'entrée.
        InputMismatchException- Si le prochain jeton ne correspond pas à l'expression régulière de Entier, ou s'il est hors de la plage
        NoSuchElementException- Si l'entrée est épuisée
        IllegalStateException- Si ce scanner est fermé
        IllegalArgumentException- Si la base est hors plage
      • hasNextInt

        public boolean hasNextInt()
        Si le prochain jeton de l'entrée de ce scanner peut être utilisénextInt()La méthode interprète la valeur comme un int dans la base par défaut, alors la méthode retourne true. Le scanner ne dépasse aucune entrée.
        Résultat : la méthode retourne true si et seulement si le prochain jeton de ce scanner est une valeur int valide. Exception
        IllegalStateException: si ce scanner est déjà fermé.
      • hasNextInt

        public boolean hasNextInt​(int radix)
        La méthode retourne true si le prochain jeton de l'entrée de ce scannernextInt()peut être interprété comme un int dans la base spécifiée. Le scanner ne dépasse aucune entrée. Si la base est inférieure

        Character.MIN_RADIXou supérieureCharacter.MAX_RADIX ,则抛出IllegalArgumentException 。

        Paramètres
        radix- Base utilisée pour interpréter le jeton comme une valeur int. Résultat Renvoie true si et seulement si le prochain jeton de ce scanner est une valeur int valide. Exception
        IllegalStateException- Si ce scanner est fermé
        IllegalArgumentException- Si la base est hors plage
      • nextInt

        public int nextInt()
        Analyse le jeton suivant de l'entrée commeint。 Appel

        nextInt()Le comportement de cette méthode sous cette forme est identique à l'appel denextInt(radix) ,其中radixEst la base par défaut de ce scanner.

        Résultat
        intAnalyse l'entrée pour détecter une exception
        InputMismatchException- Si le prochain jeton ne correspond pas à l'expression régulière Integer ou est hors limites
        NoSuchElementException- Si l'entrée est épuisée
        IllegalStateException- Si ce scanner est fermé
      • nextInt

        public int nextInt​(int radix)
        Analyse le prochain jeton de l'entrée comme unint. Si le prochain jeton ne peut pas être converti en valeur int valide, cette méthode lèveInputMismatchException, comme décrit ci-dessous. Si la conversion réussit, le scanner avance au-delà de l'entrée correspondante. Si le prochain jeton correspond à l'expression régulière Integer définie ci-dessus, le jeton est converti en

        intvaleur comme si on supprimait tous les préfixes spécifiques à la locale, les séparateurs de groupes et les suffixes spécifiques à la locale, puis comme siCharacter.digitMappez les chiffres non ASCII vers les chiffres ASCII. Ajoutez le signe moins ( - ) si un préfixe ou suffixe négatif spécifique aux paramètres régionaux existe. Passez la chaîne résultante à la fonction avec la base spécifiée.Integer.parseIntavec la base spécifiée.

        Si la base est inférieure àCharacter.MIN_RADIXou supérieure àCharacter.MAX_RADIX ,则抛出IllegalArgumentException 。

        Paramètres
        radix- La base utilisée pour interpréter le jeton comme une valeur int Résultat
        intAnalyse l'entrée pour détecter une exception
        InputMismatchException- Si le prochain jeton ne correspond pas à l'expression régulière Integer ou est hors limites
        NoSuchElementException- Si l'entrée est épuisée
        IllegalStateException- Si ce scanner est fermé
        IllegalArgumentException- Si la base est hors limites
      • hasNextLong

        public boolean hasNextLong()
        Renvoie true si le prochain jeton de l'entrée de ce scanner peut être interprété comme une valeur long dans la base par défaut avec la méthodenextLong(). Le scanner ne dépasse aucune entrée.
        Résultat true si et seulement si le prochain jeton de ce scanner est une valeur long valide Exception
        IllegalStateException- Si ce scanner est fermé
      • hasNextLong

        public boolean hasNextLong​(int radix)
        Renvoie true si le prochain jeton de l'entrée de ce scanner peut être interprété comme une valeur long dans la base spécifiée avec la méthodenextLong(). Le scanner ne dépasse aucune entrée. Si la base est inférieure à

        Character.MIN_RADIXou supérieure àCharacter.MAX_RADIX ,则抛出IllegalArgumentException 。

        Paramètres
        radix- La base utilisée pour interpréter le jeton comme une valeur long Résultat true si et seulement si le prochain jeton de ce scanner est une valeur long valide Exception
        IllegalStateException- Si ce scanner est fermé
        IllegalArgumentException- Si la base est hors limites
      • nextLong

        public long nextLong()
        Analyse le prochain jeton de l'entrée comme unlong. Appeler

        nextLong()Le comportement de cette méthode sous cette forme équivaut à appelernextLong(radix) ,其中radixest la base par défaut de ce scanner.

        Résultat
        longBalaye l'entrée. Exception
        InputMismatchException- si le prochain jeton ne correspond pas à l'expression régulière Integer ou est hors plage
        NoSuchElementException- si l'entrée est épuisée
        IllegalStateException- si ce scanner est fermé
      • nextLong

        public long nextLong​(int radix)
        Balaye le prochain jeton de l'entrée en tant quelong. Si le prochain jeton ne peut pas être converti en valeur long valide, cette méthode lèveInputMismatchException, comme décrit ci-dessous. Si la conversion réussit, le scanner dépasse l'entrée correspondante. Si le prochain jeton correspond à l'expression régulière Integer définie ci-dessus, le jeton est converti en

        longvaleur, comme si on supprimait tous les préfixes propres aux paramètres régionaux, les séparateurs de groupes et les suffixes propres aux paramètres régionaux, puis viaCharacter.digitMappe les chiffres non ASCII vers les chiffres ASCII.Long.parseLongavec la base spécifiée.

        Si la base est inférieure àCharacter.MIN_RADIXou supérieure àCharacter.MAX_RADIX ,则抛出IllegalArgumentException 。

        Paramètres
        radix- la base utilisée pour interpréter le jeton comme valeur int. Résultat. Balaye l'entrée
        long
        Exception
        InputMismatchException- si le prochain jeton ne correspond pas à l'expression régulière Integer ou est hors plage
        NoSuchElementException- si l'entrée est épuisée
        IllegalStateException- si ce scanner est fermé
        IllegalArgumentException- si la base est hors plage
      • hasNextFloat

        public boolean hasNextFloat()
        Renvoie true si le prochain jeton de l'entrée de ce scannernextFloat()peut être interprété comme valeur flottante via la méthode. Le scanner ne dépasse aucune entrée.
        Résultat. Renvoie true si et seulement si le prochain jeton de ce scanner est une valeur flottante valide. Exception
        IllegalStateException- si ce scanner est fermé
      • nextFloat

        public float nextFloat()
        Balaye le prochain jeton de l'entrée en tant quefloat. Si le prochain jeton ne peut pas être converti en valeur flottante valide, cette méthode lèveInputMismatchException, comme décrit ci-dessous. Si la conversion réussit, le scanner dépasse l'entrée correspondante. Si le prochain jeton correspond à l'expression régulière Float définie ci-dessus, le jeton est converti en

        floatvaleur, comme si on supprimait tous les préfixes propres aux paramètres régionaux, les séparateurs de groupes et les suffixes propres aux paramètres régionaux, puis viaCharacter.digitMappez les chiffres non ASCII vers les chiffres ASCII. Ajoutez le signe moins ( - ) avant, si un préfixe ou un suffixe négatif spécifique aux paramètres régionaux existe. Passez la chaîne résultante àFloat.parseFloat. Si le jeton correspond à une chaîne NaN ou infini localisée, « Nan » ou « Infinity » est passé àFloat.parseFloatselon le cas.

        Résultat. Balaye l'entrée
        float
        Exceptions
        InputMismatchException- Si le prochain jeton ne correspond pas à l'expression régulière de Float, ou est hors limites
        NoSuchElementException- Si l'entrée est épuisée
        IllegalStateException- Si ce scanner est fermé
      • hasNextDouble

        public boolean hasNextDouble()
        Renvoie true si le prochain jeton de l'entrée de ce scannernextDouble()est interprété comme une valeur double avec la méthode. Le scanner ne dépasse aucune entrée.
        Résultat true si et seulement si le prochain jeton de ce scanner est une valeur double valide. Exceptions
        IllegalStateException- Si ce scanner est fermé
      • nextDouble

        public double nextDouble()
        Lit le prochain jeton de l'entrée commedouble. Si le prochain jeton ne peut pas être converti en une valeur double valide, cette méthode lèveInputMismatchException. Si la traduction réussit, le scanner dépasse l'entrée correspondante. Si le prochain jeton correspond à l'expression régulière de Float définie ci-dessus, le jeton est converti en

        doublevaleur, comme si on supprimait tous les préfixes, séparateurs de groupes et suffixes propres à la locale, puisCharacter.digiton mappe les chiffres non ASCII vers les chiffres ASCII. On ajoute un préfixe. Si un préfixe et un suffixe négatifs propres à la locale existent, le signe moins ( - ) est passé àDouble.parseDouble. Si le jeton correspond aux chaînes NaN ou Infinity localisées, « Nan » ou « Infinity » est passé selon le cas àDouble.parseDouble.

        Résultat Lit depuis l'entrée
        double
        Exceptions
        InputMismatchException- Si le prochain jeton ne correspond pas à l'expression régulière de Float, ou est hors limites
        NoSuchElementException- Si l'entrée est épuisée
        IllegalStateException- Si ce scanner est fermé
      • hasNextBigInteger

        public boolean hasNextBigInteger()
        Renvoie true si le prochain jeton de l'entrée de ce scannernextBigInteger()peut être interprété comme unBigIntegerdans la base par défaut avec la méthode. Le scanner ne dépasse aucune entrée.
        Résultat true si et seulement si le prochain jeton de ce scanner est un
        BigInteger
        Exceptions
        IllegalStateException- Si ce scanner est fermé
      • hasNextBigInteger

        public boolean hasNextBigInteger​(int radix)
        Renvoie true si le prochain jeton de l'entrée de ce scannernextBigInteger()peut être interprété comme unBigIntegerdans la base spécifiée avec la méthode. Le scanner ne dépasse aucune entrée. Si la base est inférieure à

        Character.MIN_RADIXou supérieure àCharacter.MAX_RADIX ,则抛出IllegalArgumentException 。

        Paramètres
        radix- La base utilisée pour interpréter le jeton comme un entier. Résultat true si et seulement si le prochain jeton de ce scanner est un
        BigInteger
        Exceptions
        IllegalStateException- Si ce scanner est fermé
        IllegalArgumentException- Si la base est hors limites
      • nextBigInteger

        public BigInteger nextBigInteger()
        Scanne le prochain jeton de l'entrée commeBigInteger. L'appel

        nextBigInteger()de cette méthode sous cette forme se comporte comme l'appelnextBigInteger(radix) ,其中radixest la base par défaut de ce scanner.

        Résultat
        BigIntegerScanne depuis l'entrée. Exceptions
        InputMismatchException- Si le prochain jeton ne correspond pas à l'expression régulière Integer, ou s'il est hors limites
        NoSuchElementException- Si l'entrée est épuisée
        IllegalStateException- Si ce scanner est fermé
      • nextBigInteger

        public BigInteger nextBigInteger​(int radix)
        Scanne le prochain jeton de l'entrée commeBigInteger. Si le prochain jeton correspond à l'expression régulière Integer définie ci-dessus, le jeton est converti en

        BigIntegervaleur, comme si on supprimait tous les séparateurs de groupe, en mappant les chiffres non ASCII vers les chiffres ASCII viaCharacter.digit, puis en passant la chaîne résultante auBigInteger(String, int)constructeur avec la base spécifiée.

        Si la base est inférieure àCharacter.MIN_RADIXou supérieure àCharacter.MAX_RADIX ,则抛出IllegalArgumentException 。

        Paramètres
        radix- La base utilisée pour interpréter le jeton. Résultat Scanne depuis l'entrée.
        BigInteger
        Exceptions
        InputMismatchException- Si le prochain jeton ne correspond pas à l'expression régulière Integer, ou s'il est hors limites
        NoSuchElementException- Si l'entrée est épuisée
        IllegalStateException- Si ce scanner est fermé
        IllegalArgumentException- Si la base est hors limites
      • hasNextBigDecimal

        public boolean hasNextBigDecimal()
        Renvoie true si le prochain jeton de l'entrée de ce scannernextBigDecimal()peut être interprété commeBigDecimalpar la méthode. Le scanner ne dépasse aucune entrée.
        Résultat Vrai si et seulement si le prochain jeton de ce scanner est un
        BigDecimal
        valide.
        IllegalStateExceptionExceptions
      • nextBigDecimal

        public BigDecimal nextBigDecimal()
        nextBigDecimalBigDecimalScanne le prochain jeton de l'entrée comme

        BigDecimal. Si le prochain jeton correspond à l'expression régulière Decimal définie ci-dessus, le jeton est converti enCharacter.digitMappe les chiffres non ASCII vers des chiffres ASCII et transmet la chaîne résultante auBigDecimal(String)constructeur.

        Résultat Les éléments analysés depuis l'entrée
        BigDecimal
        Exceptions
        InputMismatchException- si le prochain jeton ne correspond pas à l'expression régulière décimale ou est hors plage
        NoSuchElementException- si l'entrée est épuisée
        IllegalStateException- si ce scanner est fermé
      • reset

        public Scanner reset()
        Réinitialise ce scanner. La réinitialisation du scanner supprime toutes les informations d'état explicites qui ont pu être modifiées par un appel à

        useDelimiter(),useLocale()ouuseRadix().

        Un appel à cette méthode de la formescanner.reset()se comporte exactement comme l'appel

        
           scanner.useDelimiter("\\p{javaWhitespace}+")
                  .useLocale(Locale.getDefault(Locale.Category.FORMAT))
                  .useRadix(10);
         
        Résultat Ce scanner Depuis la version : 1.6
      • tokens

        public Stream<String> tokens()
        Retourne un flux de jetons séparés par des délimiteurs depuis ce scanner. Le flux contient les mêmes jetons que ceux retournés à partir de l'état actuel de ce scanner en appelant de manière répétée lanext()méthode jusqu'à ce que lahasNext()méthode retourne false. Le flux résultant est séquentiel et ordonné. Tous les éléments du flux sont non null.

        La lecture commence avec l'état actuel du scanner au démarrage de l'opération terminale du flux. Tout appel ultérieur à une méthode de ce scanner autre queclose()etioException()peut retourner un résultat indéfini ou avoir un effet indéterminé sur le flux retourné. La source du flux retournéSpliterator是快速失败的 , 并且如果在流管道执行期间检测到任何此类调用,则将尽最大努力抛出ConcurrentModificationExceptionsi un tel appel est détecté pendant l'exécution du pipeline de flux.

        Une fois l'exécution du pipeline de flux terminée, ce scanner est dans un état indéterminé et ne peut pas être réutilisé.

        Si ce scanner contient des ressources qui doivent être libérées, fermez ce scanner en appelant saclose()méthode ou en fermant le flux retourné. La fermeture du flux ferme le scanner sous-jacent. Si le scanner est déjà fermé lors de l'appel de cette méthode, ou si ce scanner est fermé pendant l'exécution du pipeline de flux, uneIllegalStateException 。

        Cette méthode peut se bloquer en attendant davantage d'entrée.

        Note API : par exemple, le code suivant crée une liste de jetons séparés par des virgules à partir d'une chaîne :
           List<String> result = new Scanner("abc,def,,ghi") .useDelimiter(",") .tokens() .collect(Collectors.toList());  

        La liste résultante contiendra"abc" , "def" une chaîne vide, et"ghi" 。

        Résultat Un flux séquentiel de chaînes de jetons Exceptions
        IllegalStateException- si ce scanner est fermé Depuis la version : 9
      • findAll

        public Stream<MatchResult> findAll​(Pattern pattern)
        Retourne un flux de résultats de correspondance de ce scanner. Tant quefindWithinHorizon()des correspondances sont trouvées, le flux contient les mêmes résultats dans le même ordre, en appelantfindWithinHorizon(pattern, 0)etmatch()Retour. Le flux généré est séquentiel et ordonné. Tous les éléments du flux sont non nuls.

        Le balayage commence avec l'état actuel de ce scanner, au moment du lancement de l'opération de flux terminale. Toutclose()appel ultérieurioException()à une autre méthode de ce scanner peut renvoyer un résultat indéfini ou avoir un effet indéfini sur le flux renvoyé. La source du flux renvoyéSpliteratorest à défaillance rapide : si un tel appel est détecté pendant l'exécution du pipeline de flux, elle fait de son mieux pour leverConcurrentModificationException.

        Après l'exécution du pipeline de flux, ce scanner est dans un état indéterminé et ne peut pas être réutilisé.

        Si ce scanner contient des ressources à libérer, fermez-le en appelant saclose()méthode ou en fermant le flux renvoyé. La fermeture du flux ferme le scanner sous-jacent. Si le scanner est déjà fermé lors de l'appel de cette méthode, ou s'il est fermé pendant l'exécution du pipeline de flux, une exception est levéeIllegalStateException 。

        Comme lafindWithinHorizon()méthode, cette méthode peut se bloquer en attendant d'autres entrées et peut mettre en mémoire tampon une quantité illimitée d'entrées lors de la recherche d'une correspondance.

        Remarque API : par exemple, le code suivant lit un fichier et renvoie la liste de toutes les séquences de caractères composées de sept lettres majuscules latines ou plus :
           try (Scanner sc = new Scanner(Path.of("input.txt"))) { Pattern pat = Pattern.compile("[A-Z]{7,}"); List<String> capWords = sc.findAll(pat) .map(MatchResult::group) .collect(Collectors.toList()); }  
        Paramètres
        pattern- le motif à rechercher Résultat un flux des résultats de correspondance consécutifs Exceptions
        NullPointerException- si pattern est null
        IllegalStateException- si ce scanner est fermé Depuis : 9
      • findAll

        public Stream<MatchResult> findAll​(String patString)
        Renvoie un flux des résultats de correspondance avec la chaîne de motif fournie. L'effet est équivalent au code suivant :
           scanner.findAll(Pattern.compile(patString))  
        Paramètres
        patString- la chaîne de motif Résultat un flux des résultats de correspondance consécutifs Exceptions
        NullPointerException- si patString est null
        IllegalStateException- si ce scanner est fermé
        PatternSyntaxException- si la syntaxe de l'expression régulière est invalide Depuis : 9 Voir aussi :
        Pattern