parseerr.h File Reference

#include "unicode/utypes.h"

Go to the source code of this file.

Data Structures

struct  UParseError
 A UParseError struct is used to returned detailed information about parsing errors. More...


Typedefs

typedef UParseError UParseError
 A UParseError struct is used to returned detailed information about parsing errors.


Enumerations

enum  { U_PARSE_CONTEXT_LEN = 16 }
 The capacity of the context strings in UParseError. More...


Typedef Documentation

typedef struct UParseError UParseError
 

A UParseError struct is used to returned detailed information about parsing errors.

It is used by ICU parsing engines that parse long rules, patterns, or programs, where the text being parsed is long enough that more information than a UErrorCode is needed to localize the error.

The line, offset, and context fields are optional; parsing engines may choose not to use to use them.

The preContext and postContext strings include some part of the context surrounding the error. If the source text is "let for=7" and "for" is the error (e.g., because it is a reserved word), then some examples of what a parser might produce are the following:

 preContext   postContext
 ""           ""            The parser does not support context
 "let "       "=7"          Pre- and post-context only
 "let "       "for=7"       Pre- and post-context and error text
 ""           "for"         Error text only
 

Examples of engines which use UParseError (or may use it in the future) are Transliterator, RuleBasedBreakIterator, and RegexPattern.

Stable:
ICU 2.0


Enumeration Type Documentation

anonymous enum
 

The capacity of the context strings in UParseError.

Stable:
ICU 2.0
Enumeration values:
U_PARSE_CONTEXT_LEN 

Definition at line 22 of file parseerr.h.


Generated on Fri Jun 18 12:36:05 2004 for ICU by doxygen 1.3.7