/* Data structures and API for event locations in GDB.
- Copyright (C) 2013-2015 Free Software Foundation, Inc.
+ Copyright (C) 2013-2016 Free Software Foundation, Inc.
This file is part of GDB.
explicit location. The location must already be canonicalized/valid. */
extern char *
- explicit_location_to_string (const struct explicit_location *explicit);
+ explicit_location_to_string (const struct explicit_location *explicit_loc);
/* Return a malloc'd linespec string representation of the given
explicit location. The location must already be canonicalized/valid. */
extern char *
- explicit_location_to_linespec (const struct explicit_location *explicit);
+ explicit_location_to_linespec (const struct explicit_location *explicit_loc);
/* Return a string representation of the LOCATION.
This function may return NULL for unspecified linespecs,
/* Initialize the given explicit location. */
-extern void initialize_explicit_location (struct explicit_location *explicit);
+extern void
+ initialize_explicit_location (struct explicit_location *explicit_loc);
/* Create a new explicit location. If not NULL, EXPLICIT is checked for
validity. If invalid, an exception is thrown.
delete_event_location. */
extern struct event_location *
- new_explicit_location (const struct explicit_location *explicit);
+ new_explicit_location (const struct explicit_location *explicit_loc);
/* Return the explicit location of the given event_location
(which must be of type EXPLICIT_LOCATION). */
string_to_event_location (char **argp,
const struct language_defn *langauge);
+/* Attempt to convert the input string in *ARGP into an explicit location.
+ ARGP is advanced past any processed input. Returns an event_location
+ (malloc'd) if an explicit location was successfully found in *ARGP,
+ NULL otherwise.
+
+ IF !DONT_THROW, this function may call error() if *ARGP looks like
+ properly formed input, e.g., if it is called with missing argument
+ parameters or invalid options. If DONT_THROW is non-zero, this function
+ will not throw any exceptions. */
+
+extern struct event_location *
+ string_to_explicit_location (const char **argp,
+ const struct language_defn *langauge,
+ int dont_throw);
+
/* A convenience function for testing for unset locations. */
extern int event_location_empty_p (const struct event_location *location);