Naming Conventions¶
Traffic Server API は次の命名規則に従います。
The
TS
prefix is used for all function and variable names defined in the Traffic Server API. Examples:TS_EVENT_NONE
,TSMutex
, andTSContCreate
Enumerated values are always written in all uppercase letters. Examples:
TS_EVENT_NONE
andTS_VC_CLOSE_ABORT
Constant values are all uppercase; enumerated values can be seen as a subset of constants. Examples:
TS_URL_SCHEME_FILE
andTS_MIME_FIELD_ACCEPT
The names of defined types are mixed-case. Examples:
TSHttpSsn
andTSHttpTxn
Function names are mixed-case. Examples:
TSUrlCreate
andTSContDestroy
Function names use the following subject-verb naming style:
TS-<subject>-<verb>
, where<subject>
goes from general to specific. This makes it easier to determine what a function does by reading its name. For example: the function to retrieve the password field (the specific subject) from a URL (the general subject) isTSUrlPasswordGet
.Common verbs like
Create
,Destroy
,Get
,Set
,Copy
,Find
,Retrieve
,Insert
,Remove
, andDelete
are used only when appropriate.