Menu

- Learn
- Documentation
  - Language Reference
  - Library Reference
  - Command-line Reference
  - Feature Overview
  - Articles
- Downloads
- Packages
- Community
  - Blog
  - Orgs using D
  - Twitter
  - Calendar
  - Forums
  - IRC
  - Community Discord
  - Wiki
  - GitHub
  - Issues
  - Get involved
  - Contributors
  - Foundation
  - Security Team
  - Donate
  - Sponsors
- Resources
  - Tour
  - Books
  - Tutorials
  - Tools
  - Editors
  - IDEs
  - run.dlang.io
  - Visual D
  - Acknowledgments
  - D Style
  - Glossary
  - Sitemap

Search
Report a bug
If you spot a problem with this page, click here to create a Bugzilla issue.
Improve this page
Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using a local clone.

# dmd.errors

Functions for raising errors.
Authors:
Walter Bright
License:
Boost License 1.0

Source errors.d

Documentation https://dlang.org/phobos/dmd_errors.html

Coverage https://codecov.io/gh/dlang/dmd/src/master/src/dmd/errors.d

enum `Classification`: Color;
  Color highlighting to classify messages
  `error`
    for errors
  `gagged`
    for gagged errors
  `warning`
    for warnings
  `deprecation`
    for deprecations
  `tip`
    for tip messages
nothrow void `error`(ref const Loc `loc`, const(char)* `format`, ...);
  Print an error message, increasing the global error count.
  Parameters:

  Loc `loc` | location of error
  const(char)* `format` | printf-style format specification
  ... | printf-style variadic arguments

nothrow void `error`(Loc `loc`, const(char)* `format`, ...);
  Same as above, but allows Loc() literals to be passed.
  Parameters:

  Loc `loc` | location of error
  const(char)* `format` | printf-style format specification
  ... | printf-style variadic arguments

nothrow void `error`(const(char)* `filename`, uint `linnum`, uint `charnum`, const(char)* `format`, ...);
  Same as above, but takes a filename and line information arguments as separate parameters.
  Parameters:

  const(char)* `filename` | source file of error
  uint `linnum` | line in the source file
  uint `charnum` | column number on the line
  const(char)* `format` | printf-style format specification
  ... | printf-style variadic arguments

nothrow void `errorSupplemental`(ref const Loc `loc`, const(char)* `format`, ...);
  Print additional details about an error message. Doesn't increase the error count or print an additional error prefix.
  Parameters:

  Loc `loc` | location of error
  const(char)* `format` | printf-style format specification
  ... | printf-style variadic arguments

nothrow void `warning`(ref const Loc `loc`, const(char)* `format`, ...);
  Print a warning message, increasing the global warning count.
  Parameters:

  Loc `loc` | location of warning
  const(char)* `format` | printf-style format specification
  ... | printf-style variadic arguments

nothrow void `warningSupplemental`(ref const Loc `loc`, const(char)* `format`, ...);
  Print additional details about a warning message. Doesn't increase the warning count or print an additional warning prefix.
  Parameters:

  Loc `loc` | location of warning
  const(char)* `format` | printf-style format specification
  ... | printf-style variadic arguments

nothrow void `deprecation`(ref const Loc `loc`, const(char)* `format`, ...);
  Print a deprecation message, may increase the global warning or error count depending on whether deprecations are ignored.
  Parameters:

  Loc `loc` | location of deprecation
  const(char)* `format` | printf-style format specification
  ... | printf-style variadic arguments

nothrow void `deprecationSupplemental`(ref const Loc `loc`, const(char)* `format`, ...);
  Print additional details about a deprecation message. Doesn't increase the error count, or print an additional deprecation prefix.
  Parameters:

  Loc `loc` | location of deprecation
  const(char)* `format` | printf-style format specification
  ... | printf-style variadic arguments

nothrow void `message`(ref const Loc `loc`, const(char)* `format`, ...);
  Print a verbose message. Doesn't prefix or highlight messages.
  Parameters:

  Loc `loc` | location of message
  const(char)* `format` | printf-style format specification
  ... | printf-style variadic arguments

nothrow void `message`(const(char)* `format`, ...);
  Same as above, but doesn't take a location argument.
  Parameters:

  const(char)* `format` | printf-style format specification
  ... | printf-style variadic arguments

alias `DiagnosticHandler` = bool delegate(ref const(Loc) location, Color headerColor, const(char)* header, const(char)* messageFormat, char* args, const(char)* prefix1, const(char)* prefix2) nothrow;
  The type of the diagnostic handler see verrorPrint for arguments
  Returns:
  true if error handling is done, false to continue printing to stderr
DiagnosticHandler `diagnosticHandler`;
  The diagnostic handler. If non-null it will be called for every diagnostic message issued by the compiler. If it returns false, the message will be printed to stderr as usual.
nothrow void `tip`(const(char)* `format`, ...);
  Print a tip message with the prefix and highlighting.
  Parameters:

  const(char)* `format` | printf-style format specification
  ... | printf-style variadic arguments

nothrow void `verror`(ref const Loc `loc`, const(char)* `format`, va_list `ap`, const(char)* `p1` = null, const(char)* `p2` = null, const(char)* `header` = "Error: ");
  Same as error, but takes a va_list parameter, and optionally additional message prefixes.
  Parameters:

  Loc `loc` | location of error
  const(char)* `format` | printf-style format specification
  va_list `ap` | printf-style variadic arguments
  const(char)* `p1` | additional message prefix
  const(char)* `p2` | additional message prefix
  const(char)* `header` | title of error message

nothrow void `verrorSupplemental`(ref const Loc `loc`, const(char)* `format`, va_list `ap`);
  Same as errorSupplemental, but takes a va_list parameter.
  Parameters:

  Loc `loc` | location of error
  const(char)* `format` | printf-style format specification
  va_list `ap` | printf-style variadic arguments

nothrow void `vwarning`(ref const Loc `loc`, const(char)* `format`, va_list `ap`);
  Same as warning, but takes a va_list parameter.
  Parameters:

  Loc `loc` | location of warning
  const(char)* `format` | printf-style format specification
  va_list `ap` | printf-style variadic arguments

nothrow void `vwarningSupplemental`(ref const Loc `loc`, const(char)* `format`, va_list `ap`);
  Same as warningSupplemental, but takes a va_list parameter.
  Parameters:

  Loc `loc` | location of warning
  const(char)* `format` | printf-style format specification
  va_list `ap` | printf-style variadic arguments

nothrow void `vdeprecation`(ref const Loc `loc`, const(char)* `format`, va_list `ap`, const(char)* `p1` = null, const(char)* `p2` = null);
  Same as deprecation, but takes a va_list parameter, and optionally additional message prefixes.
  Parameters:

  Loc `loc` | location of deprecation
  const(char)* `format` | printf-style format specification
  va_list `ap` | printf-style variadic arguments
  const(char)* `p1` | additional message prefix
  const(char)* `p2` | additional message prefix

nothrow void `vmessage`(ref const Loc `loc`, const(char)* `format`, va_list `ap`);
  Same as message, but takes a va_list parameter.
  Parameters:

  Loc `loc` | location of message
  const(char)* `format` | printf-style format specification
  va_list `ap` | printf-style variadic arguments

nothrow void `vtip`(const(char)* `format`, va_list `ap`);
  Same as tip, but takes a va_list parameter.
  Parameters:

  const(char)* `format` | printf-style format specification
  va_list `ap` | printf-style variadic arguments

nothrow void `vdeprecationSupplemental`(ref const Loc `loc`, const(char)* `format`, va_list `ap`);
  Same as deprecationSupplemental, but takes a va_list parameter.
  Parameters:

  Loc `loc` | location of deprecation
  const(char)* `format` | printf-style format specification
  va_list `ap` | printf-style variadic arguments

nothrow void `fatal`();
  Call this after printing out fatal error messages to clean up and exit the compiler.
nothrow void `halt`();
  Try to stop forgetting to remove the breakpoints from release builds.
enum `HIGHLIGHT`: ubyte;
  Embed these highlighting commands in the text stream. HIGHLIGHT.Escape indicates a Color follows.

Copyright © 1999-2020 by the D Language Foundation | Page generated by Ddoc on Thu Jun 11 11:22:45 2020