tyler.durden
/
audk
mirror of https://github.com/acidanthera/audk.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

MdeModulePkg:Refine the code comments in RegularExpressionDxe. 

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Dandan Bi <dandan.bi@intel.com>
Reviewed-by: Eric Dong <eric.dong@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18444 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
Dandan Bi 2015-09-11 09:35:43 +00:00 committed by dandanbi
parent 4f7d5c6792
commit 27b5bf5d4b
3 changed files with 138 additions and 100 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

134
MdeModulePkg/Universal/RegularExpressionDxe/RegularExpressionDxe.c
View File

@ -1,5 +1,4 @@
/** /** @file
@file
EFI_REGULAR_EXPRESSION_PROTOCOL Implementation EFI_REGULAR_EXPRESSION_PROTOCOL Implementation
@ -12,6 +11,7 @@
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT
WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
**/ **/
#include "RegularExpressionDxe.h" #include "RegularExpressionDxe.h"
@ -37,8 +37,40 @@ EFI_REGULAR_EXPRESSION_PROTOCOL mProtocolInstance = {
Same parameters as RegularExpressionMatch, except SyntaxType is required. Same parameters as RegularExpressionMatch, except SyntaxType is required.
@retval EFI_SUCCESS Regex compilation and match completed successfully. @param String A pointer to a NULL terminated string to match against the
@retval EFI_DEVICE_ERROR Regex compilation failed. regular expression string specified by Pattern.
@param Pattern A pointer to a NULL terminated string that represents the
regular expression.
@param SyntaxType A pointer to the EFI_REGEX_SYNTAX_TYPE that identifies the
regular expression syntax type to use. May be NULL in which
case the function will use its default regular expression
syntax type.
@param Result On return, points to TRUE if String fully matches against
the regular expression Pattern using the regular expression
SyntaxType. Otherwise, points to FALSE.
@param Captures A Pointer to an array of EFI_REGEX_CAPTURE objects to receive
the captured groups in the event of a match. The full
sub-string match is put in Captures[0], and the results of N
capturing groups are put in Captures[1:N]. If Captures is
NULL, then this function doesn't allocate the memory for the
array and does not build up the elements. It only returns the
number of matching patterns in CapturesCount. If Captures is
not NULL, this function returns a pointer to an array and
builds up the elements in the array. CapturesCount is also
updated to the number of matching patterns found. It is the
caller's responsibility to free the memory pool in Captures
and in each CapturePtr in the array elements.
@param CapturesCount On output, CapturesCount is the number of matching patterns
found in String. Zero means no matching patterns were found
in the string.
@retval EFI_SUCCESS Regex compilation and match completed successfully.
@retval EFI_DEVICE_ERROR Regex compilation failed.
**/ **/
STATIC STATIC
EFI_STATUS EFI_STATUS
@ -144,23 +176,23 @@ OnigurumaMatch (
Returns information about the regular expression syntax types supported Returns information about the regular expression syntax types supported
by the implementation. by the implementation.
This A pointer to the EFI_REGULAR_EXPRESSION_PROTOCOL @param This A pointer to the EFI_REGULAR_EXPRESSION_PROTOCOL
instance. instance.
RegExSyntaxTypeListSize On input, the size in bytes of RegExSyntaxTypeList. @param RegExSyntaxTypeListSize On input, the size in bytes of RegExSyntaxTypeList.
On output with a return code of EFI_SUCCESS, the On output with a return code of EFI_SUCCESS, the
size in bytes of the data returned in size in bytes of the data returned in
RegExSyntaxTypeList. On output with a return code RegExSyntaxTypeList. On output with a return code
of EFI_BUFFER_TOO_SMALL, the size of of EFI_BUFFER_TOO_SMALL, the size of
RegExSyntaxTypeList required to obtain the list. RegExSyntaxTypeList required to obtain the list.
RegExSyntaxTypeList A caller-allocated memory buffer filled by the @param RegExSyntaxTypeList A caller-allocated memory buffer filled by the
driver with one EFI_REGEX_SYNTAX_TYPE element driver with one EFI_REGEX_SYNTAX_TYPE element
for each supported Regular expression syntax for each supported Regular expression syntax
type. The list must not change across multiple type. The list must not change across multiple
calls to the same driver. The first syntax calls to the same driver. The first syntax
type in the list is the default type for the type in the list is the default type for the
driver. driver.
@retval EFI_SUCCESS The regular expression syntax types list @retval EFI_SUCCESS The regular expression syntax types list
was returned successfully. was returned successfully.
@ -209,41 +241,41 @@ RegularExpressionGetInfo (
/** /**
Checks if the input string matches to the regular expression pattern. Checks if the input string matches to the regular expression pattern.
This A pointer to the EFI_REGULAR_EXPRESSION_PROTOCOL instance. @param This A pointer to the EFI_REGULAR_EXPRESSION_PROTOCOL instance.
Type EFI_REGULAR_EXPRESSION_PROTOCOL is defined in Section Type EFI_REGULAR_EXPRESSION_PROTOCOL is defined in Section
XYZ. XYZ.
String A pointer to a NULL terminated string to match against the @param String A pointer to a NULL terminated string to match against the
regular expression string specified by Pattern. regular expression string specified by Pattern.
Pattern A pointer to a NULL terminated string that represents the @param Pattern A pointer to a NULL terminated string that represents the
regular expression. regular expression.
SyntaxType A pointer to the EFI_REGEX_SYNTAX_TYPE that identifies the @param SyntaxType A pointer to the EFI_REGEX_SYNTAX_TYPE that identifies the
regular expression syntax type to use. May be NULL in which regular expression syntax type to use. May be NULL in which
case the function will use its default regular expression case the function will use its default regular expression
syntax type. syntax type.
Result On return, points to TRUE if String fully matches against @param Result On return, points to TRUE if String fully matches against
the regular expression Pattern using the regular expression the regular expression Pattern using the regular expression
SyntaxType. Otherwise, points to FALSE. SyntaxType. Otherwise, points to FALSE.
Captures A Pointer to an array of EFI_REGEX_CAPTURE objects to receive @param Captures A Pointer to an array of EFI_REGEX_CAPTURE objects to receive
the captured groups in the event of a match. The full the captured groups in the event of a match. The full
sub-string match is put in Captures[0], and the results of N sub-string match is put in Captures[0], and the results of N
capturing groups are put in Captures[1:N]. If Captures is capturing groups are put in Captures[1:N]. If Captures is
NULL, then this function doesn't allocate the memory for the NULL, then this function doesn't allocate the memory for the
array and does not build up the elements. It only returns the array and does not build up the elements. It only returns the
number of matching patterns in CapturesCount. If Captures is number of matching patterns in CapturesCount. If Captures is
not NULL, this function returns a pointer to an array and not NULL, this function returns a pointer to an array and
builds up the elements in the array. CapturesCount is also builds up the elements in the array. CapturesCount is also
updated to the number of matching patterns found. It is the updated to the number of matching patterns found. It is the
caller's responsibility to free the memory pool in Captures caller's responsibility to free the memory pool in Captures
and in each CapturePtr in the array elements. and in each CapturePtr in the array elements.
CapturesCount On output, CapturesCount is the number of matching patterns @param CapturesCount On output, CapturesCount is the number of matching patterns
found in String. Zero means no matching patterns were found found in String. Zero means no matching patterns were found
in the string. in the string.
@retval EFI_SUCCESS The regular expression string matching @retval EFI_SUCCESS The regular expression string matching
completed successfully. completed successfully.
@ -300,6 +332,12 @@ RegularExpressionMatch (
/** /**
Entry point for RegularExpressionDxe. Entry point for RegularExpressionDxe.
@param ImageHandle Image handle this driver.
@param SystemTable Pointer to SystemTable.
@retval Status Whether this function complete successfully.
**/ **/
EFI_STATUS EFI_STATUS
EFIAPI EFIAPI

94
MdeModulePkg/Universal/RegularExpressionDxe/RegularExpressionDxe.h
View File

@ -1,6 +1,4 @@
/** /** @file
@file
EFI_REGULAR_EXPRESSION_PROTOCOL Header File. EFI_REGULAR_EXPRESSION_PROTOCOL Header File.
Copyright (c) 2015, Hewlett Packard Enterprise Development, L.P.<BR> Copyright (c) 2015, Hewlett Packard Enterprise Development, L.P.<BR>
@ -12,8 +10,12 @@
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT
WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
**/ **/
#ifndef __REGULAR_EXPRESSIONDXE_H__
#define __REGULAR_EXPRESSIONDXE_H__
#include "Oniguruma/oniguruma.h" #include "Oniguruma/oniguruma.h"
#include <Uefi.h> #include <Uefi.h>
@ -29,39 +31,39 @@
/** /**
Checks if the input string matches to the regular expression pattern. Checks if the input string matches to the regular expression pattern.
This A pointer to the EFI_REGULAR_EXPRESSION_PROTOCOL instance. @param This A pointer to the EFI_REGULAR_EXPRESSION_PROTOCOL instance.
Type EFI_REGULAR_EXPRESSION_PROTOCOL is defined in Section Type EFI_REGULAR_EXPRESSION_PROTOCOL is defined in Section
XYZ. XYZ.
String A pointer to a NULL terminated string to match against the @param String A pointer to a NULL terminated string to match against the
regular expression string specified by Pattern. regular expression string specified by Pattern.
Pattern A pointer to a NULL terminated string that represents the @param Pattern A pointer to a NULL terminated string that represents the
regular expression. regular expression.
SyntaxType A pointer to the EFI_REGEX_SYNTAX_TYPE that identifies the @param SyntaxType A pointer to the EFI_REGEX_SYNTAX_TYPE that identifies the
regular expression syntax type to use. May be NULL in which regular expression syntax type to use. May be NULL in which
case the function will use its default regular expression case the function will use its default regular expression
syntax type. syntax type.
Result On return, points to TRUE if String fully matches against @param Result On return, points to TRUE if String fully matches against
the regular expression Pattern using the regular expression the regular expression Pattern using the regular expression
SyntaxType. Otherwise, points to FALSE. SyntaxType. Otherwise, points to FALSE.
Captures A Pointer to an array of EFI_REGEX_CAPTURE objects to receive @param Captures A Pointer to an array of EFI_REGEX_CAPTURE objects to receive
the captured groups in the event of a match. The full the captured groups in the event of a match. The full
sub-string match is put in Captures[0], and the results of N sub-string match is put in Captures[0], and the results of N
capturing groups are put in Captures[1:N]. If Captures is capturing groups are put in Captures[1:N]. If Captures is
NULL, then this function doesn't allocate the memory for the NULL, then this function doesn't allocate the memory for the
array and does not build up the elements. It only returns the array and does not build up the elements. It only returns the
number of matching patterns in CapturesCount. If Captures is number of matching patterns in CapturesCount. If Captures is
not NULL, this function returns a pointer to an array and not NULL, this function returns a pointer to an array and
builds up the elements in the array. CapturesCount is also builds up the elements in the array. CapturesCount is also
updated to the number of matching patterns found. It is the updated to the number of matching patterns found. It is the
caller's responsibility to free the memory pool in Captures caller's responsibility to free the memory pool in Captures
and in each CapturePtr in the array elements. and in each CapturePtr in the array elements.
CapturesCount On output, CapturesCount is the number of matching patterns @param CapturesCount On output, CapturesCount is the number of matching patterns
found in String. Zero means no matching patterns were found found in String. Zero means no matching patterns were found
in the string. in the string.
@ -91,23 +93,23 @@ RegularExpressionMatch (
Returns information about the regular expression syntax types supported Returns information about the regular expression syntax types supported
by the implementation. by the implementation.
This A pointer to the EFI_REGULAR_EXPRESSION_PROTOCOL @param This A pointer to the EFI_REGULAR_EXPRESSION_PROTOCOL
instance. instance.
RegExSyntaxTypeListSize On input, the size in bytes of RegExSyntaxTypeList. @param RegExSyntaxTypeListSize On input, the size in bytes of RegExSyntaxTypeList.
On output with a return code of EFI_SUCCESS, the On output with a return code of EFI_SUCCESS, the
size in bytes of the data returned in size in bytes of the data returned in
RegExSyntaxTypeList. On output with a return code RegExSyntaxTypeList. On output with a return code
of EFI_BUFFER_TOO_SMALL, the size of of EFI_BUFFER_TOO_SMALL, the size of
RegExSyntaxTypeList required to obtain the list. RegExSyntaxTypeList required to obtain the list.
RegExSyntaxTypeList A caller-allocated memory buffer filled by the @param RegExSyntaxTypeList A caller-allocated memory buffer filled by the
driver with one EFI_REGEX_SYNTAX_TYPE element driver with one EFI_REGEX_SYNTAX_TYPE element
for each supported Regular expression syntax for each supported Regular expression syntax
type. The list must not change across multiple type. The list must not change across multiple
calls to the same driver. The first syntax calls to the same driver. The first syntax
type in the list is the default type for the type in the list is the default type for the
driver. driver.
@retval EFI_SUCCESS The regular expression syntax types list @retval EFI_SUCCESS The regular expression syntax types list
was returned successfully. was returned successfully.
@ -127,4 +129,4 @@ RegularExpressionGetInfo (
OUT EFI_REGEX_SYNTAX_TYPE *RegExSyntaxTypeList OUT EFI_REGEX_SYNTAX_TYPE *RegExSyntaxTypeList
); );
#endif

10
MdeModulePkg/Universal/RegularExpressionDxe/RegularExpressionDxe.inf
View File

@ -1,6 +1,4 @@
## ## @file
# @file
#
# EFI_REGULAR_EXPRESSION_PROTOCOL Implementation # EFI_REGULAR_EXPRESSION_PROTOCOL Implementation
# #
# Copyright (c) 2015, Hewlett Packard Enterprise Development, L.P.<BR> # Copyright (c) 2015, Hewlett Packard Enterprise Development, L.P.<BR>
@ -67,11 +65,11 @@
DebugLib DebugLib
[Guids] [Guids]
gEfiRegexSyntaxTypePosixExtendedGuid gEfiRegexSyntaxTypePosixExtendedGuid ## CONSUMES ## GUID
gEfiRegexSyntaxTypePerlGuid gEfiRegexSyntaxTypePerlGuid ## CONSUMES ## GUID
[Protocols] [Protocols]
gEfiRegularExpressionProtocolGuid gEfiRegularExpressionProtocolGuid ## PRODUCES
[BuildOptions] [BuildOptions]
# Override MSFT build option to remove /Oi and /GL # Override MSFT build option to remove /Oi and /GL