- java.lang.Object
- java.util.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 depuis
System.in:Scanner sc = new Scanner(System.in); int i = sc.nextInt();Comme autre exemple, ce code permet d'assigner des entrées depuis le fichier
myNumbers.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 blueLe 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éthodes
findInLine(),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 une
InputMismatchException, 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'interface
Readable. 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 du
Scanner, 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ètre
nullànull任何方法Scannerprovoquera le lancement d'uneNullPointerException。Sauf si une base différente est définie avec la méthode
useRadix(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éthode
Locale.getDefault(Locale.Category.FORMAT). Elle se modifie avec la méthodeuseLocale().reset()La méthoderé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 nouveauScannerqui génère des valeurs lues depuis le fichier spécifié.Scanner(File source, String charsetName)Construit un nouveauScannerqui génère des valeurs lues depuis le fichier spécifié.Scanner(File source, Charset charset)Construit un nouveauScannerqui 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 nouveauScannerIl 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 nouveauScannerIl génère les valeurs analysées à partir du fichier spécifié.Scanner(Path source, String charsetName)Construisez un nouveauScannerIl 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 voidclose()Ferme ce scanner.Patterndelimiter()RetournePatternCeciScannerest 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.StringfindInLine(String pattern)Tente de trouver le prochain motif construit à partir de la chaîne spécifiée, en ignorant les délimiteurs.StringfindInLine(Pattern pattern)Recherche la prochaine occurrence du motif spécifié en ignorant les séparateurs.StringfindWithinHorizon(String pattern, int horizon)Trouve le prochain motif construit à partir de la chaîne spécifiée, en ignorant les séparateurs.StringfindWithinHorizon(Pattern pattern, int horizon)Recherche l'occurrence suivante du motif spécifié.booleanhasNext()Retourne true si l'entrée de ce scanner contient un autre jeton.booleanhasNext(String pattern)Retourne true si le prochain jeton correspond au motif construit à partir de la chaîne spécifiée.booleanhasNext(Pattern pattern)Renvoie true si le prochain marqueur complet correspond au motif spécifié.booleanhasNextBigDecimal()Si le prochain jeton de l'entrée de ce scanner peut être utilisénextBigDecimal()La méthode s'explique ainsi.BigDecimal则返回true。booleanhasNextBigInteger()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。booleanhasNextBigInteger(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。booleanhasNextBoolean()Renvoie true si le prochain token de l'entrée de ce scanner peut être interprété comme une valeur booléenne.booleanhasNextByte()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.booleanhasNextByte(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.booleanhasNextDouble()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.booleanhasNextFloat()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.booleanhasNextInt()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.booleanhasNextInt(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.booleanhasNextLine()Si l'entrée de ce scanner contient une autre ligne, cette méthode renvoie true.booleanhasNextLong()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.booleanhasNextLong(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.booleanhasNextShort()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.booleanhasNextShort(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.IOExceptionioException()RenvoieIOExceptionle type de base de la dernière exceptionScannerlancée parReadable。Localelocale()Renvoie la locale de ce scanner.MatchResultmatch()Renvoie le résultat de correspondance de la dernière opération de balayage effectuée par ce scanner.Stringnext()Recherche et renvoie le prochain jeton complet de ce scanner.Stringnext(String pattern)Renvoie le prochain jeton s'il correspond au motif construit à partir de la chaîne spécifiée.Stringnext(Pattern pattern)Renvoie le prochain jeton s'il correspond au motif spécifié.BigDecimalnextBigDecimal()Balaye le prochain jeton de l'entrée commeBigDecimal.BigIntegernextBigInteger()Balaye le prochain jeton de l'entrée commeBigInteger.BigIntegernextBigInteger(int radix)Balaye le prochain jeton de l'entrée commeBigInteger.booleannextBoolean()Balaye le prochain jeton de l'entrée comme une valeur booléenne et renvoie cette valeur.bytenextByte()Balaye le prochain jeton de l'entrée commebyte。bytenextByte(int radix)Balaye le prochain jeton de l'entrée commebyte。doublenextDouble()Balaye le prochain jeton de l'entrée commedouble。floatnextFloat()Balaye le prochain jeton de l'entrée commefloat。intnextInt()Analyse le prochain jeton de l'entrée commeint。intnextInt(int radix)Analyse le prochain jeton de l'entrée commeint。StringnextLine()Avance ce scanner au-delà de la ligne actuelle et retourne l'entrée ignorée.longnextLong()Analyse le prochain jeton de l'entrée commelong。longnextLong(int radix)Analyse le prochain jeton de l'entrée commelong。shortnextShort()Analyse le prochain jeton de l'entrée commeshort。shortnextShort(int radix)Analyse le prochain jeton de l'entrée commeshort。intradix()Retourne la base par défaut de ce scanner.voidremove()IteratorCette implémentation de ne prend pas en charge l'opération de suppression.Scannerreset()Réinitialise ce scanner.Scannerskip(String pattern)Ignore l'entrée qui correspond au motif construit à partir de la chaîne spécifiée.Scannerskip(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.StringtoString()Retourne une représentation sous forme de chaîne de ceScanner的字符串表示Scanner。ScanneruseDelimiter(String pattern)Définit le motif de séparation de ce scanner sur le motif construit à partir duStringspécifié.ScanneruseDelimiter(Pattern pattern)Définit le motif de séparation de ce scanner sur le motif spécifié.ScanneruseLocale(Locale locale)Définit la locale de ce scanner sur la locale spécifiée.ScanneruseRadix(int radix)Définit la base par défaut de ce scanner sur la base spécifiée.-
声明方法的类 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
声明方法的接口 java.util.Iterator
forEachRemaining
-
-
-
-
构造方法详细信息
-
Scanner
public Scanner(Readable source)
Construit un nouveauScannerqui 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 à analysercharsetName- Le type d'encodage utilisé pour convertir les octets du flux en caractères à analyser. ExceptionsIllegalArgumentException- 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 à analysercharset- 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. ExceptionsFileNotFoundException- 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 à analysercharsetName- Le type d'encodage utilisé pour convertir les octets du fichier en caractères à analyser. ExceptionsFileNotFoundException- Si la source est introuvableIllegalArgumentException- 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 à analysercharset- Le jeu de caractères utilisé pour convertir les octets du fichier en caractères à analyser. ExceptionsIOException- 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. ExceptionsIOException- 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 à analysercharsetName- Le type d'encodage utilisé pour convertir les octets du fichier en caractères à analyser. ExceptionsIOException- Si une erreur d'E/S se produit à l'ouverture de la sourceIllegalArgumentException- 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 à analysercharset- Le jeu de caractères utilisé pour convertir les octets du fichier en caractères à analyser. ExceptionsIOException- Si une erreur d'E/S se produit à l'ouverture de la source. Depuis la version : 10
-
Scanner
public Scanner(String source)
Construit un nouveauScannerqui 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 à analysercharsetName- Le type d'encodage utilisé pour convertir les octets du canal en caractères à analyser. ExceptionsIllegalArgumentException- 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 à analysercharset- 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émenteCloseablel'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 provoquera
IllegalStateException.- 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()
RetournePatternleScannerde 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 formeuseDelimiter(pattern)se comporte comme l'appel deuseDelimiter(Pattern.compile(pattern))。L'appel de la méthode
reset()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 à la
reset()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 à la
reset()méthode rétablit la base du scanner sur10。- Paramètres
radix- base à utiliser pour scanner les nombres. Résultat ce scanner. ExceptionIllegalArgumentException- 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érentesnext的方法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 ce
Scanner的字符串表示ScannerLa représentation sous forme de chaîneScanner的字符串表示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, interfaceIterator<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 :
nextinterfaceIterator<String>- Résultat La prochaine marque. Exception
NoSuchElementException- si aucune autre marque n'est disponibleIllegalStateException- si ce scanner est fermé. Voir aussi :Iterator
-
remove
public void remove()
IteratorCette implémentation de ne prend pas en charge l'opération de suppression.- Spécifié par :
remove在界面Iterator<String>- Exception
UnsupportedOperationException- si cette méthode est appelée. 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é. ExceptionIllegalStateException- 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. ExceptionNoSuchElementException- si aucune marque de ce type n'est disponibleIllegalStateException- 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é. ExceptionsIllegalStateException- 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)返回truecette 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. ExceptionsNoSuchElementException- Si aucun token n'est disponibleIllegalStateException- 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éeIllegalStateException- 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 formefindInLine(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é. ExceptionsIllegalStateException- 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é. ExceptionsIllegalStateException- 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 formefindWithinHorizon(pattern)se comporte comme un appel defindWithinHorizon(Pattern.compile(pattern), horizon)。- Paramètres
pattern- Chaîne spécifiant le motif à rechercherhorizon- Portée de recherche Résultat Texte correspondant au motif spécifié ExceptionsIllegalStateException- 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 code
horizonsuivant 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 est
0, 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 à analyserhorizon- Portée de recherche Résultat Texte correspondant au motif spécifié ExceptionsIllegalStateException- 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 exceptionNoSuchElementException。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 risquer
sc.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 ExceptionsNoSuchElementException- 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 deskip(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 ExceptionsIllegalStateException- 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 valideNoSuchElementException- si l'entrée est épuiséeIllegalStateException- 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. ExceptionsIllegalStateException- 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 formenextByte()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. ExceptionsInputMismatchException- si le prochain token ne correspond pas à l'expression régulière Integer, ou s'il est hors limitesNoSuchElementException- si l'entrée est épuiséeIllegalStateException- 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 enbyteLa 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 limitesNoSuchElementException- Si l'entrée est épuiséeIllegalStateException- Si ce scanner est éteintIllegalArgumentException- 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érieureCharacter.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. ExceptionIllegalStateException- Si ce scanner est éteintIllegalArgumentException- Si la base est hors plage
-
nextShort
public short nextShort()
Scannez le jeton suivant de l'entrée en tant queshortAppelnextShort()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 limitesNoSuchElementException- Si l'entrée est épuiséeIllegalStateException- 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 valeurshortcomme 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ésultatshortAnalyser 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 plageNoSuchElementException- Si l'entrée est épuiséeIllegalStateException- 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érieureCharacter.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. ExceptionIllegalStateException- 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。 AppelnextInt()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 exceptionInputMismatchException- Si le prochain jeton ne correspond pas à l'expression régulière Integer ou est hors limitesNoSuchElementException- Si l'entrée est épuiséeIllegalStateException- 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 enintvaleur 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ésultatintAnalyse l'entrée pour détecter une exceptionInputMismatchException- Si le prochain jeton ne correspond pas à l'expression régulière Integer ou est hors limitesNoSuchElementException- Si l'entrée est épuiséeIllegalStateException- 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 ExceptionIllegalStateException- 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. AppelernextLong()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. ExceptionInputMismatchException- si le prochain jeton ne correspond pas à l'expression régulière Integer ou est hors plageNoSuchElementException- si l'entrée est épuiséeIllegalStateException- 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 enlongvaleur, 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éelong- Exception
InputMismatchException- si le prochain jeton ne correspond pas à l'expression régulière Integer ou est hors plageNoSuchElementException- si l'entrée est épuiséeIllegalStateException- 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 enfloatvaleur, 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 limitesNoSuchElementException- Si l'entrée est épuiséeIllegalStateException- 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 endoublevaleur, 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 limitesNoSuchElementException- Si l'entrée est épuiséeIllegalStateException- 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 unBigInteger- 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'appelnextBigInteger()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. ExceptionsInputMismatchException- Si le prochain jeton ne correspond pas à l'expression régulière Integer, ou s'il est hors limitesNoSuchElementException- Si l'entrée est épuiséeIllegalStateException- 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 enBigIntegervaleur, 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 limitesNoSuchElementException- Si l'entrée est épuiséeIllegalStateException- 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 commeBigDecimal. 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 plageNoSuchElementException- si l'entrée est épuiséeIllegalStateException- 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 forme
scanner.reset()se comporte exactement comme l'appelscanner.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 que
close()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 sa
close()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. Tout
close()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 sa
close()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 la
findWithinHorizon()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 ExceptionsNullPointerException- si pattern est nullIllegalStateException- 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 ExceptionsNullPointerException- si patString est nullIllegalStateException- si ce scanner est ferméPatternSyntaxException- si la syntaxe de l'expression régulière est invalide Depuis : 9 Voir aussi :Pattern
-
-