Search packages, repositories and app categories

GitHub repositorydart-archive/string_scanner

string_scanner

A class for parsing strings using a sequence of patterns.

string_scanner project cover
Stars
54
Forks
17
Last push (UTC)
Dec 17, 2024
Project status
Archived

Original README

English project snapshot. Visit GitHub for the latest content.

[!IMPORTANT]
This repo has moved to https://github.com/dart-lang/tools/tree/main/pkgs/string_scanner

Dart CI pub package package publisher

This package exposes a StringScanner type that makes it easy to parse a string using a series of Patterns. For example:

import 'dart:math' as math;

import 'package:string_scanner/string_scanner.dart';

num parseNumber(String source) {
  // Scan a number ("1", "1.5", "-3").
  final scanner = StringScanner(source);

  // [Scanner.scan] tries to consume a [Pattern] and returns whether or not it
  // succeeded. It will move the scan pointer past the end of the pattern.
  final negative = scanner.scan('-');

  // [Scanner.expect] consumes a [Pattern] and throws a [FormatError] if it
  // fails. Like [Scanner.scan], it will move the scan pointer forward.
  scanner.expect(RegExp(r'\d+'));

  // [Scanner.lastMatch] holds the [MatchData] for the most recent call to
  // [Scanner.scan], [Scanner.expect], or [Scanner.matches].
  var number = num.parse(scanner.lastMatch![0]!);

  if (scanner.scan('.')) {
    scanner.expect(RegExp(r'\d+'));
    final decimal = scanner.lastMatch![0]!;
    number += int.parse(decimal) / math.pow(10, decimal.length);
  }

  // [Scanner.expectDone] will throw a [FormatError] if there's any input that
  // hasn't yet been consumed.
  scanner.expectDone();

  return (negative ? -1 : 1) * number;
}
Dart Archive GitHub avatar
GitHub author

Dart Archive ↗

Legacy projects kept around for posterity – See github.com/dart-lang for current work

LanguagesDart

Dependencies used

Dependency list 3 items

  • source_span^1.8.0
  • dart_flutter_team_lintsDevelopment^3.0.0
  • testDevelopment^1.16.6

How do I choose a repository?

Start with your use case, compare repository activity, and check the original project before adopting it.

  1. Search by repository name, owner or description, then narrow the results by topic.
  2. Compare stars, forks and recent pushes. Stars show community interest, not a guarantee of quality.
  3. Read the README, license and issues on GitHub before using a project.

Sources and maintenance

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗