ajtext.c

Datatypes: AjPText none


Datatype: AjPText

Text data

Sections: constructors Text data destructors Casts text data modifiers


Section: constructors

Constructors

Functions: ajTextNew


Function ajTextNew

Text data constructor

Synopsis

Prototype
AjPText ajTextNew (
      void
);

TypeNameRead/WriteDescription
AjPText RETURNNew object

Returns
AjPText:New object

Description

Text data constructor

See Also

See other functions in this section

Availability

In release 6.4.0

Section: Text data destructors

Destruction destroys all internal data structures and frees the memory allocated for the text data object.

Functions: ajTextDel


Function ajTextDel

Text data destructor

Synopsis

Prototype
void ajTextDel (
      AjPText* Ptext
);

TypeNameRead/WriteDescription
AjPText*PtextDeleteText data object to delete
void RETURN

Output
Ptext:(Delete)Text data object to delete
Returns
void:No return value

Description

Text data destructor

See Also

See other functions in this section

Availability

In release 6.4.0

Section: Casts

Return values from a text data object

Functions: ajTextGetQryC ajTextGetQryS


Function ajTextGetQryC

Returns the query string of a text data object. Because this is a pointer to the real internal string the caller must take care not to change the character string in any way. If the string is to be changed (case for example) then it must first be copied.

Synopsis

Prototype
const char* ajTextGetQryC (
      const AjPText text
);

TypeNameRead/WriteDescription
const AjPTexttextInputText data object.
const char* RETURNQuery as a character string.

Input
text:(Input)Text data object.
Returns
const char*:Query as a character string.

Description

Returns the query string of a text data object. Because this is a pointer to the real internal string the caller must take care not to change the character string in any way. If the string is to be changed (case for example) then it must first be copied.

See Also

See other functions in this section

Availability

In release 6.4.0

Function ajTextGetQryS

Returns the query string of a text data object. Because this is a pointer to the real internal string the caller must take care not to change the character string in any way. If the string is to be changed (case for example) then it must first be copied.

Synopsis

Prototype
const AjPStr ajTextGetQryS (
      const AjPText text
);

TypeNameRead/WriteDescription
const AjPTexttextInputText data object.
const AjPStr RETURNQuery as a string.

Input
text:(Input)Text data object.
Returns
const AjPStr:Query as a string.

Description

Returns the query string of a text data object. Because this is a pointer to the real internal string the caller must take care not to change the character string in any way. If the string is to be changed (case for example) then it must first be copied.

See Also

See other functions in this section

Availability

In release 6.4.0

Section: text data modifiers

Text data modifiers

Functions: ajTextClear


Function ajTextClear

Resets all data for a text data object so that it can be reused.

Synopsis

Prototype
void ajTextClear (
      AjPText text
);

TypeNameRead/WriteDescription
AjPTexttextModifytext data
void RETURN

Input & Output
text:(Modify)text data
Returns
void:No return value

Description

Resets all data for a text data object so that it can be reused.

See Also

See other functions in this section

Availability

In release 6.4.0

Datatype: none

Miscellaneous functions

Sections: exit


Section: exit

Functions called on exit from the program by ajExit to do any necessary cleanup and to report internal statistics to the debug file

Functions: ajTextExit


Function ajTextExit

Cleans up text processing internal memory

Synopsis

Prototype
void ajTextExit (
      void
);

TypeNameRead/WriteDescription
void RETURN

Returns
void:No return value

Description

Cleans up text processing internal memory

See Also

See other functions in this section

Availability

In release 6.4.0