Top | ![]() |
![]() |
![]() |
![]() |
void * | cut_take () |
const void * | cut_take_memory () |
const char * | cut_take_string () |
const char * | cut_take_strdup () |
const char * | cut_take_strndup () |
const void * | cut_take_memdup () |
const char * | cut_take_printf () |
char ** | cut_take_string_array () |
const char * | cut_take_diff () |
const char * | cut_take_replace () |
#define | cut_take_convert() |
const char * | cut_take_inspect_string () |
void | cut_set_fixture_data_dir () |
char * | cut_build_fixture_data_path () |
#define | cut_build_fixture_path() |
const char * | cut_get_fixture_data_string () |
#define | cut_get_fixture_data() |
void | cut_remove_path () |
const char * | cut_build_path () |
const char * | cut_build_path_array () |
void | cut_make_directory () |
To write tests, you need to write codes that set up/tear down test environment, prepare expected and actual values and so on. Cutter provides test utilities to you write your tests more easily.
The utilities work without GLib support.
void * cut_take (void *object
,CutDestroyFunction destroy_function
);
Passes ownership of object
to Cutter and returns object
itself. object
is destroyed by destroy_func
.
object |
the object to be owned by Cutter. |
|
destroy_function |
the destroy function for the object. |
Since: 1.0.5
const void *
cut_take_memory (void *memory
);
Passes ownership of memory
to Cutter and returns memory
itself. memory
is destroyed by free()
.
Since: 1.0.5
const char *
cut_take_string (char *string
);
Passes ownership of string
to Cutter and returns string
itself.
const char *
cut_take_strdup (const char *string
);
Duplicates string
, passes ownership of the duplicated
string to Cutter and returns the duplicated string.
Since: 1.0.5
const char * cut_take_strndup (const char *string
,size_t size
);
Duplicates the first size
bytes of string
, passes
ownership of the duplicated string to Cutter and returns
the duplicated string. The duplicated string is always
NULL
-terminated.
Since: 1.0.5
const void * cut_take_memdup (const void *memory
,size_t size
);
Duplicates size
bytes of memory
, passes ownership of
the duplicated memory to Cutter and returns the
duplicated memory.
Since: 1.0.5
const char * cut_take_printf (const char *format
,...
);
Formats a string like printf()
but the formatted string
is owned by Cutter.
char **
cut_take_string_array (char **strings
);
Passes ownership of the array of strings to Cutter and
returns strings
itself.
const char * cut_take_diff (const char *from
,const char *to
);
Computes diff between from
and to
that is owned by Cutter.
const char * cut_take_replace (const char *target
,const char *pattern
,const char *replacement
);
Replaces all occurrences of the pattern
with the
replacement
in the target
string.
target |
the replace target string. |
|
pattern |
the regular expression pattern as string. |
|
replacement |
text to replace each match with |
Since: 1.0.6
#define cut_take_convert(string, to_code_set, from_code_set)
Converts string
code set to to_code_set
from
from_code_set
.
string |
the convert target string. It should be |
|
to_code_set |
the code set name which to convert |
|
from_code_set |
the code set name of |
Since: 1.1.3
const char *
cut_take_inspect_string (const char *string
);
Inspects string
.
Since: 1.1.4
void cut_set_fixture_data_dir (const char *path
,...
);
Set fixture data directory that is used by
cut_get_fixture_data_string()
and so on.
path |
a first element of the path to the fixture data directory. |
|
... |
remaining elements in path.
|
Since: 1.0.2
char * cut_build_fixture_data_path (const char *path
,...
);
cut_build_fixture_data_path
has been deprecated since version 1.1.6 and should not be used in newly-written code.
Use cut_build_fixture_path()
instead.
Builds a path to the fixture data. If path
is relative
path, the path is handled as a relative path from a
directory that is specified by cut_set_fixture_data_dir()
or the current directory.
path |
a first element of the path to the fixture data. |
|
... |
remaining elements in path.
|
Since: 1.0.2
#define cut_build_fixture_path(...)
Builds a path to the fixture data. If path
is relative
path, the path is handled as a relative path from a
directory that is specified by cut_set_fixture_data_dir()
or the current directory.
path |
a first element of the path to the fixture data. |
|
... |
remaining elements in path.
|
Since: 1.1.6
const char * cut_get_fixture_data_string (const char *path
,...
);
Reads the fixture data at "path
/..." and returns it as a
string that is owned by Cutter. The description of
cut_build_fixture_path()
shows how the fixture data path
is determined.
path |
a first element of the path to the fixture data. |
|
... |
remaining elements in path.
|
Since: 1.0.2
#define cut_get_fixture_data(size, ...)
Reads the fixture data at "path
/..." and returns it as a
string that is owned by Cutter. The description of
cut_build_fixture_path()
shows how the fixture data path
is determined.
Since: 1.1.6
void cut_remove_path (const char *path
,...
);
Removes path
and it's children recursively. It doesn't
report any errors.
path |
a first element of the path to be removed. |
|
... |
remaining elements in path.
|
Since: 1.0.2
const char * cut_build_path (const char *path
,...
);
Builds path from path
and the following elements.
Since: 1.0.7
const char *
cut_build_path_array (const char **paths
);
Builds path from paths
.
Since: 1.1.5
void cut_make_directory (const char *path
,...
);
Makes path
and it's parents recursively. It doesn't
report any errors.
path |
a first element of the path to be made. |
|
... |
remaining elements in path. |
Since: 1.1.1