X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/c9eee7f035ebc6b5c044475d508b018ae9fb5bc2..3cc305b2b4a0674c56c84d7088cfd70676b850f0:/docs/latex/wx/regex.tex diff --git a/docs/latex/wx/regex.tex b/docs/latex/wx/regex.tex index 58687c9934..59026f0d71 100644 --- a/docs/latex/wx/regex.tex +++ b/docs/latex/wx/regex.tex @@ -118,6 +118,10 @@ printf("text now contains %u hidden addresses", count); +\wxheading{Library} + +\helpref{wxBase}{librarieslist} + \latexignore{\rtfignore{\wxheading{Members}}} \membersection{wxRegEx::wxRegEx}\label{wxregexwxregex} @@ -197,12 +201,15 @@ returns {\tt true} if matches and {\tt false} otherwise. {\it Flags} may be combination of {\tt wxRE\_NOTBOL} and {\tt wxRE\_NOTEOL}. -System regex libraries always assume the text being searched is null -terminated and any length given is ignored. +Some regex libraries assume that the text given is null terminated, while +others require the length be given as a separate parameter. Therefore for +maximum portability assume that {\it text} cannot contain embedded nulls. -When using the built-in regex library, the first overload obtains the length -of the string using wxStrlen, the second from the {\it len} parameter and the -third from the length of the {\it wxString}. +When the {\it Matches(const wxChar *text, int flags = 0)} form is used, +a {\it wxStrlen()} will be done internally if the regex library requires the +length. When using {\it Matches()} in a loop +the {\it Matches(text, flags, len)} form can be used instead, making it +possible to avoid a {\it wxStrlen()} inside the loop. May only be called after successful call to \helpref{Compile()}{wxregexcompile}.