• Home
• GNU PDF Library
• PDF Knowledge
• Community
• Sponsors
• Contact

Lib:Test Specification Document

From GNUpdf

Contents 1 GNU PDF Library Test Specification Document 2 Unit Testing 2.1 Base Layer Modules 2.1.1 Memory Allocation Module 2.1.1.1 pdf_alloc 2.1.1.2 pdf_realloc 2.1.1.3 pdf_dealloc 2.1.2 Filesystem Module 2.1.2.1 pdf_fsys_open 2.1.3 Stream Module 2.1.3.1 pdf_create_file_stm 2.1.4 Text Module 2.1.4.1 pdf_text_init 2.1.4.2 pdf_text_new_destroy 2.1.4.3 pdf_text_dup 2.1.4.4 pdf_text_new_from_host 2.1.4.5 pdf_text_new_from_pdf_string 2.1.4.6 pdf_text_new_from_unicode 2.1.4.7 pdf_text_new_from_u32 2.1.4.8 pdf_text_get_country 2.1.4.9 pdf_text_get_language 2.1.4.10 pdf_text_set_country 2.1.4.11 pdf_text_set_language 2.1.4.12 pdf_text_empty_p 2.1.4.13 pdf_text_get_host_encoding 2.1.4.14 pdf_text_check_host_encoding 2.1.4.15 pdf_text_get_best_encoding 2.1.4.16 pdf_text_get_host 2.1.4.17 pdf_text_get_pdfdocenc 2.1.4.18 pdf_text_get_unicode 2.1.4.19 pdf_text_get_hex 2.1.4.20 pdf_text_set_host 2.1.4.21 pdf_text_set_pdfdocenc 2.1.4.22 pdf_text_set_unicode 2.1.4.23 pdf_text_concat 2.1.4.24 pdf_text_replace 2.1.4.25 pdf_text_replace_ascii 2.1.4.26 pdf_text_filter 2.1.4.27 pdf_text_cmp 2.1.5 List Module 2.1.5.1 pdf_list_add_at 2.1.5.2 pdf_list_add_first 2.1.5.3 pdf_list_add_last 2.1.5.4 pdf_list_create 2.1.5.5 pdf_list_destroy 2.1.5.6 pdf_list_get_at 2.1.5.7 pdf_list_indexof_from_to 2.1.5.8 pdf_list_indexof_from 2.1.5.9 pdf_list_indexof 2.1.5.10 pdf_list_iterator_from_to 2.1.5.11 pdf_list_iterator_next 2.1.5.12 pdf_list_iterator 2.1.5.13 pdf_list_iterator_free 2.1.5.14 pdf_list_next_node 2.1.5.15 pdf_list_node_value 2.1.5.16 pdf_list_previous_node 2.1.5.17 pdf_list_remove_at 2.1.5.18 pdf_list_remove_node 2.1.5.19 pdf_list_remove 2.1.5.20 pdf_list_search_from_to 2.1.5.21 pdf_list_search_from 2.1.5.22 pdf_list_search 2.1.5.23 pdf_list_set_at 2.1.5.24 pdf_list_size 2.1.5.25 pdf_list_sorted_add 2.1.5.26 pdf_list_sorted_remove 2.1.5.27 pdf_list_sorted_indexof 2.1.5.28 pdf_list_sorted_indexof_from_to 2.1.5.29 pdf_list_sorted_search 2.1.5.30 pdf_list_sorted_search_from_to 2.1.6 Hash Module 2.1.6.1 pdf_hash_create 2.1.6.2 pdf_hash_detroy 2.1.6.3 pdf_hash_size 2.1.6.4 pdf_hash_key_p 2.1.6.5 pdf_hash_rename 2.1.6.6 pdf_hash_add 2.1.6.7 pdf_hash_remove 2.1.6.8 pdf_hash_search 2.1.6.9 pdf_hash_iterator 2.1.6.10 pdf_hash_iterator_next 2.1.6.11 pdf_hash_iterator_free 2.1.7 Error Module 2.1.7.1 pdf_error 2.1.7.2 pdf_perror 2.1.8 Types Module 2.1.8.1 pdf_i64_add 2.1.8.2 pdf_i64_abs 2.1.8.3 pdf_i64_assign 2.1.8.4 pdf_i64_assign_quick 2.1.8.5 pdf_i64_cmp 2.1.8.6 pdf_i64_copy 2.1.8.7 pdf_i64_neg 2.1.8.8 pdf_i64_new 3 Subsystem Testing 4 System Testing 5 GNU Free Documentation License 5.1 ADDENDUM: How to use this License for your documents 6 Function index 7 Table of Contents 8 About This Document

GNU PDF Library Test Specification Document

GNU PDF Library Test Specification Document

This is the GNU PDF Library Test Specification Document, updated for libgnupdf version 0.1.

Copyright © 2007, 2008 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

Unit Testing

Base Layer Modules

Memory Allocation Module

pdf_alloc

Test: pdf_alloc_001

Allocate some bytes.

Success condition

The call should not produce an error.

pdf_realloc

Test: pdf_realloc_001

Reallocate some bytes.

Success condition

The call should not produce an error.

pdf_dealloc

Test: pdf_dealloc_001

Deallocate memory.

Success condition

The call should not produce an error.

Filesystem Module

pdf_fsys_open

Test: pdf_fsys_open_001

Open an existent and readable file for reading.

Success condition

pdf_fsys_open should return PDF_OK.

Test: pdf_fsys_open_002

Open a non-existent and writable file for writing.

Success condition

pdf_fsys_open should return PDF_OK.

Test: pdf_fsys_open_003

Open an existing and writable file for writing.

Success condition

pdf_fsys_open should return PDF_OK.

Test: pdf_fsys_open_004

Open an existing, readable and writable file for reading and writing.

Success condition

pdf_fsys_open should return PDF_OK.

Stream Module

pdf_create_file_stm

Test: pdf_create_file_stm_001

Try to open a file stream to a non-existing file.

Success condition

pdf_create_file_stm should return a NULL pointer.

Test: pdf_create_file_stm_002

Open a file stream to an existing file in read-only mode.

Success condition

pdf_create_file_stm should return a correct stream object.

Test: pdf_create_file_stm_003

Open a file stream to a non existing file in write-only mode.

Success condition

pdf_create_file_stm should return a correct stream object.

Test: pdf_create_file_stm_004

Open a file stream to an existing file in write-only mode.

Success condition

pdf_create_file_stm should return a correct stream object.

Text Module

pdf_text_init

Test: pdf_text_init_001

Initialize text module

Success conditions

1. The call should not produce an error.

2. A valid (non-empty) host encoding should be detected.

3. A valid host endianness should be detected (either LE or BE).

4. A valid (non-empty) host EOL marker should be detected.

5. A valid (non-empty) language ID should be detected.

pdf_text_new_destroy

Test: pdf_text_new_destroy_001

Create an empty text object and destroy it

Success conditions

1. The call to pdf_text_new should not return a NULL pointer.

2. The text data of the created object should be empty.

3. The language code of the output object should be empty

4. The country code of the output object should be empty

5. The call to pdf_text_destroy should return PDF_OK;

pdf_text_dup

Test: pdf_text_dup_001

Duplicate an empty text object

Success conditions

1. The call to pdf_text_dup should not return a NULL pointer.

2. The text data of the created object should be empty.

3. The language code of the output object should be empty

4. The country code of the output object should be empty

Test: pdf_text_dup_002

Duplicate a text object with data contents but no language/country code

Success conditions

1. The call to pdf_text_dup should not return a NULL pointer.

2. The text data of the output object should be equal to the text data of the input object.

3. The language code of the output object should be empty

4. The country code of the output object should be empty

Test: pdf_text_dup_003

Duplicate a text object with data contents and language code

Success conditions

1. The call to pdf_text_dup should not return a NULL pointer.

2. The text data of the output object should be equal to the text data of the input object.

3. The language code of the output object should be equal to the language code of the input object.

4. The country code of the output object should be empty.

Test: pdf_text_dup_004

Duplicate a text object with data contents, language code and country code

Success conditions

1. The call to pdf_text_dup should not return a NULL pointer.

2. The text data of the output object should be equal to the text data of the input object.

3. The language code of the output object should be equal to the language code of the input object.

4. The country code of the output object should be equal to the country code of the input object.

pdf_text_new_from_host

Test: pdf_text_new_from_host_001

Create a text object with an input valid host-encoded string

Success conditions

1. The call to pdf_text_new_from_host should return PDF_OK.

2. The contents of the text object must be the expected ones.

Test: pdf_text_new_from_host_002

Create a text object with an input invalid host-encoded string

Success conditions

1. The call to pdf_text_new_from_host should NOT return PDF_OK.

Test: pdf_text_new_from_host_003

Create a text object with an input string encoded in an invalid host encoding

Success conditions

1. The call to pdf_text_new_from_host should NOT return PDF_OK.

pdf_text_new_from_pdf_string

Test: pdf_text_new_from_pdf_string_001

Create a text object with an input valid PDF-Doc-Encoded string

Success conditions

1. The call to pdf_text_new_from_pdf_string should return PDF_OK.

2. The contents of the text object must be the expected ones.

3. The language code within the text object must be empty.

4. The country code within the text object must be empty.

5. The call should return a NULL remaining_str pointer and a zero remaining_length

Test: pdf_text_new_from_pdf_string_002

Create a text object with an input invalid PDF-Doc-Encoded string

Success conditions

1. The call to pdf_text_new_from_pdf_string should NOT return PDF_OK.

2. Pointer to the text object must remain unchanged.

Test: pdf_text_new_from_pdf_string_003

Create a text object with an input valid UTF-16BE encoded string with BOM (containing both 16-bit and 32-bit UTF-16 code points!) and without lang/country information.

Success conditions

1. The call to pdf_text_new_from_pdf_string should return PDF_OK.

2. The function should return a valid pointer to the new text object.

3. The contents of the text object must be the expected ones.

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

5. The call should return a NULL remaining_str pointer and a zero remaining_length

Test: pdf_text_new_from_pdf_string_004

Create a text object with an input valid UTF-16BE encoded string without BOM

Success conditions

1. The call to pdf_text_new_from_pdf_string should NOT return PDF_OK.

2. Pointer to the text object must remain unchanged.

Test: pdf_text_new_from_pdf_string_005

Create a text object with an input invalid UTF-16BE encoded string with BOM

Success conditions

1. The call to pdf_text_new_from_pdf_string should NOT return PDF_OK.

2. Pointer to the text object must remain unchanged.

Test: pdf_text_new_from_pdf_string_006

Create a text object with an input valid UTF-16BE encoded string with BOM (containing both 16-bit and 32-bit UTF-16 code points!) which also contains a valid language code embedded.

Success conditions

1. The call to pdf_text_new_from_pdf_string should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones.

4. The languange code within the text object must be the expected one.

5. The country code within the text object must be empty.

6. The call should return a NULL remaining_str pointer and a zero remaining_length

Test: pdf_text_new_from_pdf_string_007

Create a text object with an input valid UTF-16BE encoded string with BOM (containing both 16-bit and 32-bit UTF-16 code points!) which also contains a valid language code and a valid country code embedded.

Success conditions

1. The call to pdf_text_new_from_pdf_string should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones.

4. The languange code within the text object must be the expected one.

5. The country code within the text object must be the expected one.

6. The call should return a NULL remaining_str pointer and a zero remaining_length

Test: pdf_text_new_from_pdf_string_008

Create a text object with an input valid UTF-16BE encoded string with BOM (containing both 16-bit and 32-bit UTF-16 code points!) which also contains more than one (three) valid language code embedded (the string contains more than one string in more than one different language).

Success conditions

1. The first call to pdf_text_new_from_pdf_string should return PDF_OK.

2. The first call should return a valid pointer to the new text object

3. The contents of the first text object must be the expected ones.

4. The languange code within the first text object must be the expected one.

5. The country code within the first text object must be empty.

6. The first call should return a valid remaining_str pointer and a non-zero remaining_length

7. The second call to pdf_text_new_from_pdf_string should return PDF_OK.

8. The second call should return a valid pointer to the new text object

9. The contents of the second text object must be the expected ones.

10. The languange code within the second text object must be the expected one.

11. The country code within the second text object must be empty.

12. The second call should return a valid remaining_str pointer and a non-zero remaining_length

13. The third call to pdf_text_new_from_pdf_string should return PDF_OK.

14. The third call should return a valid pointer to the new text object

15. The contents of the third text object must be the expected ones.

16. The languange code within the third text object must be the expected one.

17. The country code within the third text object must be empty.

18. The second call should return a NULL remaining_str pointer and a zero remaining_length

Test: pdf_text_new_from_pdf_string_009

Create a text object with an input valid UTF-16BE encoded string with BOM (containing both 16-bit and 32-bit UTF-16 code points!) which also contains more than one (three) valid language code and a valid country code embedded (the string contains more than one string in more than one different language/country).

Success conditions

1. The first call to pdf_text_new_from_pdf_string should return PDF_OK.

2. The first call should return a valid pointer to the new text object

3. The contents of the first text object must be the expected ones.

4. The languange code within the first text object must be the expected one.

5. The country code within the first text object must be the expected one.

6. The first call should return a valid remaining_str pointer and a non-zero remaining_length

7. The second call to pdf_text_new_from_pdf_string should return PDF_OK.

8. The second call should return a valid pointer to the new text object

9. The contents of the second text object must be the expected ones.

10. The languange code within the second text object must be the expected one.

11. The country code within the second text object must be the expected one.

12. The second call should return a valid remaining_str pointer and a non-zero remaining_length

13. The third call to pdf_text_new_from_pdf_string should return PDF_OK.

14. The third call should return a valid pointer to the new text object

15. The contents of the third text object must be the expected ones.

16. The languange code within the third text object must be the expected one.

17. The country code within the third text object must be the expected one.

18. The second call should return a NULL remaining_str pointer and a zero remaining_length

pdf_text_new_from_unicode

Test: pdf_text_new_from_unicode_001

Create a text object with an input valid UTF-8 encoded string (containing 8-bit, 16-bit, 24-bit and 32-bit code points!) without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones (without BOM).

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_002

Create a text object with an input valid UTF-16BE encoded string (16-bit and 32-bit code points!) without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones (without BOM).

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_003

Create a text object with an input valid UTF-16LE encoded string (16-bit and 32-bit code points!) without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones (without BOM).

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_004

Create a text object with an input valid UTF-16HE encoded string (16-bit and 32-bit code points!) without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones (without BOM).

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_005

Create a text object with an input valid UTF-32BE encoded string without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones (without BOM).

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_006

Create a text object with an input valid UTF-32LE encoded string without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones (without BOM).

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_007

Create a text object with an input valid UTF-32HE encoded string without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the object must be completely equal to the input data

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_008

Create a text object with an input valid UTF-8 encoded string (containing 8-bit, 16-bit, 24-bit and 32-bit code points!) with BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones (without BOM).

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_009

Create a text object with an input valid UTF-16BE encoded string (16-bit and 32-bit code points!) with BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones (without BOM).

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_010

Create a text object with an input valid UTF-16LE encoded string (16-bit and 32-bit code points!) with BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones (without BOM).

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_011

Create a text object with an input valid UTF-16HE encoded string (16-bit and 32-bit code points!) with BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones (without BOM).

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_012

Create a text object with an input valid UTF-32BE encoded string with BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones (without BOM).

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_013

Create a text object with an input valid UTF-32LE encoded string with BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the text object must be the expected ones (without BOM).

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_014

Create a text object with an input valid UTF-32HE encoded string with BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The function should return a valid pointer to the new text object

3. The contents of the object must be completely equal to the input data

4. The language code within the text object must be empty.

5. The country code within the text object must be empty.

Test: pdf_text_new_from_unicode_015

Create a text object with an input invalid UTF-8 encoded string without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should NOT return PDF_OK.

2. Pointer to the text object must remain unchanged.

Test: pdf_text_new_from_unicode_016

Create a text object with an input invalid UTF-16BE encoded string without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should NOT return PDF_OK.

2. Pointer to the text object must remain unchanged.

Test: pdf_text_new_from_unicode_017

Create a text object with an input invalid UTF-16LE encoded string without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should NOT return PDF_OK.

2. Pointer to the text object must remain unchanged.

Test: pdf_text_new_from_unicode_018

Create a text object with an input invalid UTF-16HE encoded string without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should NOT return PDF_OK.

2. Pointer to the text object must remain unchanged.

Test: pdf_text_new_from_unicode_019

Create a text object with an input invalid UTF-32BE encoded string without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should NOT return PDF_OK.

2. Pointer to the text object must remain unchanged.

Test: pdf_text_new_from_unicode_020

Create a text object with an input invalid UTF-32LE encoded string without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should NOT return PDF_OK.

2. Pointer to the text object must remain unchanged.

Test: pdf_text_new_from_unicode_021

Create a text object with an input invalid UTF-32HE encoded string without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should NOT return PDF_OK.

2. Pointer to the text object must remain unchanged.

pdf_text_new_from_u32

Test: pdf_text_new_from_u32_001

Create a text object given '0' as input number

Success conditions

1. The call to pdf_text_new_from_u32 should return PDF_OK.

2. The contents of the text object must be the expected ones.

Test: pdf_text_new_from_u32_001

Create a text object given a non-zero positive number

Success conditions

1. The call to pdf_text_new_from_u32 should return PDF_OK.

2. The contents of the text object must be the expected ones.

pdf_text_get_country

Test: pdf_text_get_country_001

Get country ID when the stored country ID is valid

Success conditions

1. The call to pdf_text_get_country should return a valid pointer.

2. The length of the returned string should be 2.

Test: pdf_text_get_country_002

Get country ID when the stored country ID is invalid

Success conditions

1. The call to pdf_text_get_country should return a valid pointer.

2. The length of the returned string should be 0.

pdf_text_get_language

Test: pdf_text_get_language_001

Get language ID when the stored language ID is valid

Success conditions

1. The call to pdf_text_get_language should return a valid pointer.

2. The length of the returned string should be 2.

Test: pdf_text_get_language_002

Get language ID when the stored language ID is invalid

Success conditions

1. The call to pdf_text_get_language should return a valid pointer.

2. The length of the returned string should be 0.

pdf_text_set_country

Test: pdf_text_set_country_001

Set a valid two-character country ID

Success conditions

1. The call to pdf_text_set_country should return PDF_OK.

2. The contents of the internal country ID representation should be the expected ones.

Test: pdf_text_set_country_002

Set an invalid one-character country ID

Success conditions

1. The call to pdf_text_set_country should NOT return PDF_OK.

Test: pdf_text_set_country_003

Set an invalid empty country ID

Success conditions

1. The call to pdf_text_set_country should NOT return PDF_OK.

pdf_text_set_language

Test: pdf_text_set_language_001

Set a valid two-character language ID

Success conditions

1. The call to pdf_text_set_language should return PDF_OK.

2. The contents of the internal language ID representation should be the expected ones.

Test: pdf_text_set_language_002

Set an invalid one-character language ID

Success conditions

1. The call to pdf_text_set_language should NOT return PDF_OK.

Test: pdf_text_set_language_003

Set an invalid empty language ID

Success conditions

1. The call to pdf_text_set_language should NOT return PDF_OK.

pdf_text_empty_p

Test: pdf_text_empty_p_001

Check if a given empty text object is empty

Success conditions

1. The call to pdf_text_empty_p should return PDF_TRUE.

Test: pdf_text_empty_p_002

Check if a given non-empty text object is empty

Success conditions

1. The call to pdf_text_empty_p should return PDF_FALSE.

pdf_text_get_host_encoding

Test: pdf_text_get_host_encoding_001

Get the host encoding configured by the user. As this test really depends on what the user has configured in the system, the unit test will only check that a non-empty host encoding is returned.

Success conditions

1. The call to pdf_text_get_host_encoding should return a non-empty pdf_text_host_encoding_t variable.

pdf_text_check_host_encoding

Test: pdf_text_check_host_encoding_001

Check if a given valid host encoding is available in the system. ASCII-7 is considered as the host encoding that every system should at least have, so the test will check for it.

Success conditions

1. The call to pdf_text_check_host_encoding should return PDF_OK.

2. A non-empty pdf_text_host_encoding_t variable should be returned as well.

Test: pdf_text_check_host_encoding_002

Check if a given invalid host encoding is available in the system. An inexistent host encoding will be requested.

Success conditions

1. The call to pdf_text_check_host_encoding should NOT return PDF_OK.

2. The pdf_text_host_encoding_t variable should remain unchanged.

pdf_text_get_best_encoding

Test: pdf_text_get_best_encoding_001

Check if a best encoding is returned. If available, it must return a valid Unicode-based host encoding. If no Unicode encoding is available, it should return the preferred encoding. As this test really depends on what the user has configured in the system, the unit test will only check that a non-empty host encoding is returned.

Success conditions

1. The call to pdf_text_get_best_encoding should return a non-empty pdf_text_host_encoding_t variable.

pdf_text_get_host

Test: pdf_text_get_host_001

Get the contents of a text object in a valid host encoding

Success conditions

1. The call to pdf_text_get_host should return PDF_OK.

2. The returned string must be the expected one.

Test: pdf_text_get_host_002

Get the contents of a text object in an invalid host encoding

Success conditions

1. The call to pdf_text_get_host should NOT return PDF_OK.

pdf_text_get_pdfdocenc

Test: pdf_text_get_pdfdocenc_001

Get the contents of a text object in PDF Doc Encoding. The contents of the text object can all be transformed to PDF Doc Encoding without loss of information.

Success conditions

1. The call to pdf_text_get_pdfdocenc should return PDF_OK.

2. The returned string must be the expected one, and NUL terminated

Test: pdf_text_get_pdfdocenc_002

Get the contents of a text object in PDF Doc Encoding. The contents of the text object cannot be transformed to PDF Doc Encoding without loss of information. A default character must be used for those characters that cannot be represented in PDF Doc Encoding.

Success conditions

1. The call to pdf_text_get_pdfdocenc should return PDF_OK.

2. The returned string must be the expected one, and NUL terminated

pdf_text_get_unicode

Test: pdf_text_get_unicode_001

Get the contents of a non-empty text object in UTF-8 without BOM. The contents of the text object include characters that are encoded in UTF-8 using 8-bit, 16-bit, 24-bit and 32-bit.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, not NUL terminated.

3. The returned length must be the expected one.

Test: pdf_text_get_unicode_002

Get the contents of a non-empty text object in UTF-8 with BOM. The contents of the text object include characters that are encoded in UTF-8 using 8-bit, 16-bit, 24-bit and 32-bit.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, not NUL terminated.

3. The returned length must be the expected one, including the length of the BOM in UTF-8.

Test: pdf_text_get_unicode_003

Get the contents of an empty text object in UTF-8 without BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be NULL.

3. The returned length must be zero.

Test: pdf_text_get_unicode_004

Get the contents of an empty text object in UTF-8 with BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must only contain the BOM in UTF-8, not NUL terminated.

3. The returned length must be equal to the length of the BOM in UTF-8.

Test: pdf_text_get_unicode_005

Get the contents of a non-empty text object with lang/country info, in UTF-8 without BOM and with lang/country information embedded (which should not be supported in UTF-8).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_006

Get the contents of a non-empty text object with lang/country info, in UTF-8 with BOM and with lang/country information embedded (which should not be supported in UTF-8).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_007

Get the contents of a non-empty text object in UTF-16BE without BOM. The contents of the text object include characters that are encoded in UTF-16 using 16-bit and 32-bit.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, not NUL terminated.

3. The returned length must be the expected one.

Test: pdf_text_get_unicode_008

Get the contents of a non-empty text object in UTF-16BE with BOM. The contents of the text object include characters that are encoded in UTF-16 using 16-bit and 32-bit.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, not NUL terminated.

3. The returned length must be the expected one, including the length of the BOM in UTF-16.

Test: pdf_text_get_unicode_009

Get the contents of an empty text object in UTF-16BE without BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be NULL.

3. The returned length must be zero.

Test: pdf_text_get_unicode_010

Get the contents of an empty text object in UTF-16BE with BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must only contain the BOM in UTF-16BE, not NUL terminated.

3. The returned length must be equal to the length of the BOM in UTF-16.

Test: pdf_text_get_unicode_011

Get the contents of a non-empty text object with lang/country info, in UTF-16BE without BOM and with lang/country information embedded (which IS supported in UTF-16BE).

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, including the lang/country information embedded, not NUL terminated.

3. The returned length must be the expected one, including the length of the lang/country info.

Test: pdf_text_get_unicode_012

Get the contents of a non-empty text object with language info (no country info), in UTF-16BE without BOM and with lang/country information embedded (which IS supported in UTF-16BE).

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, including the language information embedded, not NUL terminated.

3. The returned length must be the expected one, including the length of the language info.

Test: pdf_text_get_unicode_013

Get the contents of an empty text object with lang/country info, in UTF-16BE without BOM and with lang/country information embedded (which IS supported in UTF-16BE).

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must only include the lang/country information embedded, not NUL terminated.

3. The returned length must be equal to the length of the lang/country info.

Test: pdf_text_get_unicode_014

Get the contents of an empty text object with language info (no country info), in UTF-16BE without BOM and with lang/country information embedded (which IS supported in UTF-16BE).

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must only contain the language information embedded, not NUL terminated.

3. The returned length must be equal to the length of the language info.

Test: pdf_text_get_unicode_015

Get the contents of a non-empty text object with lang/country info, in UTF-16BE with BOM and with lang/country information embedded (which IS supported in UTF-16BE).

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, including the BOM and the lang/country information embedded, not NUL terminated.

3. The returned length must be the expected one, including the length of the lang/country info and the BOM.

Test: pdf_text_get_unicode_016

Get the contents of a non-empty text object with language info (no country info), in UTF-16BE with BOM and with lang/country information embedded (which IS supported in UTF-16BE).

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, including the BOM and the language information embedded, not NUL terminated.

3. The returned length must be the expected one, including the length of the language info and the BOM.

Test: pdf_text_get_unicode_017

Get the contents of an empty text object with lang/country info, in UTF-16BE with BOM and with lang/country information embedded (which IS supported in UTF-16BE).

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must only include the BOM and lang/country information embedded, not NUL terminated.

3. The returned length must be equal to the length of the lang/country info plus the length of the BOM.

Test: pdf_text_get_unicode_018

Get the contents of an empty text object with language info (no country info), in UTF-16BE with BOM and with lang/country information embedded (which IS supported in UTF-16BE).

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must only contain the BOM and the language information embedded, not NUL terminated.

3. The returned length must be equal to the length of the language info plus the length of the BOM.

Test: pdf_text_get_unicode_019

Get the contents of a non-empty text object in UTF-16LE without BOM. The contents of the text object include characters that are encoded in UTF-16 using 16-bit and 32-bit.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, not NUL terminated.

3. The returned length must be the expected one.

Test: pdf_text_get_unicode_020

Get the contents of a non-empty text object in UTF-16LE with BOM. The contents of the text object include characters that are encoded in UTF-16 using 16-bit and 32-bit.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, not NUL terminated.

3. The returned length must be the expected one, including the length of the BOM in UTF-16.

Test: pdf_text_get_unicode_021

Get the contents of an empty text object in UTF-16LE without BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be NULL.

3. The returned length must be zero.

Test: pdf_text_get_unicode_022

Get the contents of an empty text object in UTF-16LE with BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must only contain the BOM in UTF-16LE, not NUL terminated.

3. The returned length must be equal to the length of the BOM in UTF-16.

Test: pdf_text_get_unicode_023

Get the contents of a non-empty text object with lang/country info, in UTF-16LE without BOM and with lang/country information embedded (which is NOT supported in UTF-16LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_024

Get the contents of a non-empty text object with language info (no country info), in UTF-16LE without BOM and with lang/country information embedded (which is NOT supported in UTF-16LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_025

Get the contents of an empty text object with lang/country info, in UTF-16LE without BOM and with lang/country information embedded (which is NOT supported in UTF-16LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_026

Get the contents of an empty text object with language info (no country info), in UTF-16LE without BOM and with lang/country information embedded (which is NOT supported in UTF-16LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_027

Get the contents of a non-empty text object with lang/country info, in UTF-16LE with BOM and with lang/country information embedded (which is NOT supported in UTF-16LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_028

Get the contents of a non-empty text object with language info (no country info), in UTF-16LE with BOM and with lang/country information embedded (which is NOT supported in UTF-16LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_029

Get the contents of an empty text object with lang/country info, in UTF-16LE with BOM and with lang/country information embedded (which is NOT supported in UTF-16LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_030

Get the contents of an empty text object with language info (no country info), in UTF-16LE with BOM and with lang/country information embedded (which is NOT supported in UTF-16LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_031

Get the contents of a non-empty text object in UTF-32BE without BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, not NUL terminated.

3. The returned length must be the expected one.

Test: pdf_text_get_unicode_032

Get the contents of a non-empty text object in UTF-32BE with BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, not NUL terminated.

3. The returned length must be the expected one, including the length of the BOM in UTF-32.

Test: pdf_text_get_unicode_033

Get the contents of an empty text object in UTF-32BE without BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be NULL.

3. The returned length must be zero.

Test: pdf_text_get_unicode_034

Get the contents of an empty text object in UTF-32BE with BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must only contain the BOM in UTF-32BE, not NUL terminated.

3. The returned length must be equal to the length of the BOM in UTF-32.

Test: pdf_text_get_unicode_035

Get the contents of a non-empty text object with lang/country info, in UTF-32BE without BOM and with lang/country information embedded (which is NOT supported in UTF-32BE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_036

Get the contents of a non-empty text object with language info (no country info), in UTF-32BE without BOM and with lang/country information embedded (which is NOT supported in UTF-32BE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_037

Get the contents of an empty text object with lang/country info, in UTF-32BE without BOM and with lang/country information embedded (which is NOT supported in UTF-32BE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_038

Get the contents of an empty text object with language info (no country info), in UTF-32BE without BOM and with lang/country information embedded (which is NOT supported in UTF-32BE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_039

Get the contents of a non-empty text object with lang/country info, in UTF-32BE with BOM and with lang/country information embedded (which is NOT supported in UTF-32BE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_040

Get the contents of a non-empty text object with language info (no country info), in UTF-32BE with BOM and with lang/country information embedded (which is NOT supported in UTF-32BE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_041

Get the contents of an empty text object with lang/country info, in UTF-32BE with BOM and with lang/country information embedded (which is NOT supported in UTF-32BE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_042

Get the contents of an empty text object with language info (no country info), in UTF-32BE with BOM and with lang/country information embedded (which is NOT supported in UTF-32BE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_043

Get the contents of a non-empty text object in UTF-32LE without BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, not NUL terminated.

3. The returned length must be the expected one.

Test: pdf_text_get_unicode_044

Get the contents of a non-empty text object in UTF-32LE with BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be the expected one, not NUL terminated.

3. The returned length must be the expected one, including the length of the BOM in UTF-32.

Test: pdf_text_get_unicode_045

Get the contents of an empty text object in UTF-32LE without BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must be NULL.

3. The returned length must be zero.

Test: pdf_text_get_unicode_046

Get the contents of an empty text object in UTF-32LE with BOM.

Success conditions

1. The call to pdf_text_get_unicode should return PDF_OK.

2. The returned string must only contain the BOM in UTF-32LE, not NUL terminated.

3. The returned length must be equal to the length of the BOM in UTF-32.

Test: pdf_text_get_unicode_047

Get the contents of a non-empty text object with lang/country info, in UTF-32LE without BOM and with lang/country information embedded (which is NOT supported in UTF-32LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_048

Get the contents of a non-empty text object with language info (no country info), in UTF-32LE without BOM and with lang/country information embedded (which is NOT supported in UTF-32LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_049

Get the contents of an empty text object with lang/country info, in UTF-32LE without BOM and with lang/country information embedded (which is NOT supported in UTF-32LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_050

Get the contents of an empty text object with language info (no country info), in UTF-32LE without BOM and with lang/country information embedded (which is NOT supported in UTF-32LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_051

Get the contents of a non-empty text object with lang/country info, in UTF-32LE with BOM and with lang/country information embedded (which is NOT supported in UTF-32LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_052

Get the contents of a non-empty text object with language info (no country info), in UTF-32LE with BOM and with lang/country information embedded (which is NOT supported in UTF-32LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_053

Get the contents of an empty text object with lang/country info, in UTF-32LE with BOM and with lang/country information embedded (which is NOT supported in UTF-32LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

Test: pdf_text_get_unicode_054

Get the contents of an empty text object with language info (no country info), in UTF-32LE with BOM and with lang/country information embedded (which is NOT supported in UTF-32LE).

Success conditions

1. The call to pdf_text_get_unicode should NOT return PDF_OK.

pdf_text_get_hex

Test: pdf_text_get_hex_001

Get the contents of a non-empty text object in Hexadecimal representation in ASCII

Success conditions

1. The call to pdf_text_get_hex should return a valid string, NUL terminated.

2. The contents of the returned string must be the expected ones.

3. The length of the string must be non-zero.

Test: pdf_text_get_hex_002

Get the contents of an empty text object in Hexadecimal representation in ASCII

Success conditions

1. The call to pdf_text_get_hex should return a valid string, NUL terminated.

2. The length of the string must be zero.

pdf_text_set_host

Test: pdf_text_set_host_001

Set the contents of a text object with an input valid host-encoded string

Success conditions

1. The call to pdf_text_set_host should return PDF_OK.

2. The contents of the text object must be the expected ones.

Test: pdf_text_set_host_002

Set the contents of a text object with an input invalid host-encoded string

Success conditions

1. The call to pdf_text_set_host should NOT return PDF_OK.

Test: pdf_text_set_host_003

Set the contents of a text object with an input string encoded in an invalid host encoding

Success conditions

1. The call to pdf_text_set_host should NOT return PDF_OK.

pdf_text_set_pdfdocenc

Test: pdf_text_set_pdfdocenc_001

Set the contents of a text object with an input valid PDF Doc Encoded string

Success conditions

1. The call to pdf_text_set_pdfdocenc should return PDF_OK.

2. The contents of the text object must be the expected ones.

Test: pdf_text_set_pdfdocenc_002

Set the contents of a text object with an input empty PDF Doc Encoded string

Success conditions

1. The call to pdf_text_set_pdfdocenc should return PDF_OK.

2. The contents of the text object must be empty.

Test: pdf_text_set_pdfdocenc_003

Set the contents of a text object with an input invalid PDF Doc Encoded string

Success conditions

1. The call to pdf_text_set_pdfdocenc should NOT return PDF_OK.

pdf_text_set_unicode

Test: pdf_text_set_unicode_001

Set the contents of a text object with an input valid UTF-8 encoded string (containing 8-bit, 16-bit, 24-bit and 32-bit code points!) without BOM

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_002

Set the contents of a text object with an input valid UTF-16BE encoded string (16-bit and 32-bit code points!) without BOM

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_003

Set the contents of a text object with an input valid UTF-16LE encoded string (16-bit and 32-bit code points!) without BOM

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_004

Set the contents of a text object with an input valid UTF-16HE encoded string (16-bit and 32-bit code points!) without BOM

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_005

Set the contents of a text object with an input valid UTF-32BE encoded string without BOM

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_006

Set the contents of a text object with an input valid UTF-32LE encoded string without BOM

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_007

Set the contents of a text object with an input valid UTF-32HE encoded string without BOM

Success conditions

1. The call to pdf_text_new_from_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_008

Set the contents of a text object with an input valid UTF-8 encoded string (containing 8-bit, 16-bit, 24-bit and 32-bit code points!) with BOM

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_009

Set the contents of a text object with an input valid UTF-16BE encoded string (16-bit and 32-bit code points!) with BOM

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_010

Set the contents of a text object with an input valid UTF-16LE encoded string (16-bit and 32-bit code points!) with BOM

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_011

Set the contents of a text object with an input valid UTF-16HE encoded string (16-bit and 32-bit code points!) with BOM

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_012

Set the contents of a text object with an input valid UTF-32BE encoded string with BOM

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_013

Set the contents of a text object with an input valid UTF-32LE encoded string with BOM

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_014

Set the contents of a text object with an input valid UTF-32HE encoded string with BOM

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones (without BOM).

Test: pdf_text_set_unicode_015

Set the contents of a text object with an input invalid UTF-8 encoded string without BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_016

Set the contents of a text object with an input invalid UTF-16BE encoded string without BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_017

Set the contents of a text object with an input invalid UTF-16LE encoded string without BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_018

Set the contents of a text object with an input invalid UTF-16HE encoded string without BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_019

Set the contents of a text object with an input invalid UTF-32BE encoded string without BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_020

Set the contents of a text object with an input invalid UTF-32LE encoded string without BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_021

Set the contents of a text object with an input invalid UTF-32HE encoded string without BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_022

Set the contents of a text object with an input invalid UTF-8 encoded string with BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_023

Set the contents of a text object with an input invalid UTF-16BE encoded string with BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_024

Set the contents of a text object with an input invalid UTF-16LE encoded string with BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_025

Set the contents of a text object with an input invalid UTF-16HE encoded string with BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_026

Set the contents of a text object with an input invalid UTF-32BE encoded string with BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_027

Set the contents of a text object with an input invalid UTF-32LE encoded string with BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_028

Set the contents of a text object with an input invalid UTF-32HE encoded string with BOM

Success conditions

1. The call to pdf_text_set_unicode should NOT return PDF_OK.

2. The contents of the text object must remain unchanged.

Test: pdf_text_set_unicode_029

Set the contents of a text object with an input valid UTF-16BE encoded string with BOM and embedded language/country information (it should treat that information as standard UTF-16BE)

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones.

3. The language code must be empty.

4. The country code must be empty.

Test: pdf_text_set_unicode_030

Set the contents of a text object with an input valid UTF-16BE encoded string without BOM and embedded language/country information (it should treat that information as standard UTF-16BE)

Success conditions

1. The call to pdf_text_set_unicode should return PDF_OK.

2. The contents of the text object must be the expected ones.

3. The language code must be empty.

4. The country code must be empty.

pdf_text_concat

Test: pdf_text_concat_001

Concatenate two non-empty text objects with the same lang/country information. Don't override langinfo.

Success conditions

1. The call to pdf_text_concat should return PDF_OK.

2. The contents of the output text object must be the expected ones.

3. The lang/country information in the output object must remain unchanged.

Test: pdf_text_concat_002

Concatenate two non-empty text objects without lang/country information. Don't override langinfo.

Success conditions

1. The call to pdf_text_concat should return PDF_OK.

2. The contents of the output text object must be the expected ones.

3. The lang/country information in the output object must be empty.

Test: pdf_text_concat_003

Concatenate two non-empty text objects with different lang/country information. Don't override langinfo.

Success conditions

1. The call to pdf_text_concat should NOT return PDF_OK.

2. The contents of the output text object must remain unchanged.

Test: pdf_text_concat_004

Concatenate two empty text objects with the same lang/country information. Don't override langinfo.

Success conditions

1. The call to pdf_text_concat should return PDF_OK.

2. The contents of the output text object should be empty.

3. The lang/country information in the output object must remain unchanged.

Test: pdf_text_concat_005

Concatenate two empty text objects without lang/country information. Don't override langinfo.

Success conditions

1. The call to pdf_text_concat should return PDF_OK.

2. The contents of the output text object should be empty.

3. The lang/country information in the output object must be empty.

Test: pdf_text_concat_006

Concatenate two empty text objects with different lang/country information. Don't override langinfo.

Success conditions

1. The call to pdf_text_concat should NOT return PDF_OK.

2. The contents of the output text object must remain unchanged.

Test: pdf_text_concat_007

Concatenate two non-empty text objects with the same lang/country information. Override langinfo.

Success conditions

1. The call to pdf_text_concat should return PDF_OK.

2. The contents of the output text object must be the expected ones.

3. The lang/country information in the output object must remain unchanged.

Test: pdf_text_concat_008

Concatenate two non-empty text objects without lang/country information. Override langinfo.

Success conditions

1. The call to pdf_text_concat should return PDF_OK.

2. The contents of the output text object must be the expected ones.

3. The lang/country information in the output object must be empty.

Test: pdf_text_concat_009

Concatenate two non-empty text objects with different lang/country information. Override langinfo.

Success conditions

1. The call to pdf_text_concat should return PDF_OK.

2. The contents of the output text object must be the expected ones.

3. The lang/country information in the output object must remain unchanged.

Test: pdf_text_concat_010

Concatenate two empty text objects with the same lang/country information. Override langinfo.

Success conditions

1. The call to pdf_text_concat should return PDF_OK.

2. The contents of the output text object should be empty.

3. The lang/country information in the output object must remain unchanged.

Test: pdf_text_concat_011

Concatenate two empty text objects without lang/country information. Override langinfo.

Success conditions

1. The call to pdf_text_concat should return PDF_OK.

2. The contents of the output text object should be empty.

3. The lang/country information in the output object must be empty.

Test: pdf_text_concat_012

Concatenate two empty text objects with different lang/country information. Override langinfo.

Success conditions

1. The call to pdf_text_concat should return PDF_OK.

2. The contents of the output text object should be empty.

3. The lang/country information in the output object must be empty.

pdf_text_replace

Test: pdf_text_replace_001

Replace an old non-empty pattern with a new non-empty pattern of different sizes (old > new). At least one replacement is done.

Success conditions

1. The call to pdf_text_replace should return PDF_OK.

2. The contents of the output text object must be the expected ones.

Test: pdf_text_replace_002

Replace an old non-empty pattern with a new non-empty pattern of different sizes (old < new). At least one replacement is done.

Success conditions

1. The call to pdf_text_replace should return PDF_OK.

2. The contents of the output text object must be the expected ones.

Test: pdf_text_replace_003

Replace an old non-empty pattern with a new non-empty pattern of same sizes. At least one replacement is done.

Success conditions

1. The call to pdf_text_replace should return PDF_OK.

2. The contents of the output text object must be the expected ones.

Test: pdf_text_replace_004

Replace an old non-empty pattern with a new empty pattern (remove old pattern from text). At least one replacement is done.

Success conditions

1. The call to pdf_text_replace should return PDF_OK.

2. The contents of the output text object must be the expected ones.

Test: pdf_text_replace_005

Replace an old non-empty pattern with a new non-empty pattern of different sizes (old > new). No replacement is done.

Success conditions

1. The call to pdf_text_replace should return PDF_OK.

2. The contents of the output text object remain unchanged.

Test: pdf_text_replace_006

Replace an old non-empty pattern with a new non-empty pattern of different sizes (old < new). No replacement is done.

Success conditions

1. The call to pdf_text_replace should return PDF_OK.

2. The contents of the output text object remain unchanged.

Test: pdf_text_replace_007

Replace an old non-empty pattern with a new non-empty pattern of same sizes. No replacement is done.

Success conditions

1. The call to pdf_text_replace should return PDF_OK.

2. The contents of the output text object remain unchanged.

Test: pdf_text_replace_008

Replace an old non-empty pattern with a new empty pattern (remove old pattern from text). No replacement is done.

Success conditions

1. The call to pdf_text_replace should return PDF_OK.

2. The contents of the output text object remain unchanged.

Test: pdf_text_replace_009

Replace an old empty pattern with a new non-empty pattern (old pattern can't be empty!)

Success conditions

1. The call to pdf_text_replace should NOT return PDF_OK.

Test: pdf_text_replace_010

Replace an old non-empty pattern with a new non-empty pattern in an empty text object.

Success conditions

1. The call to pdf_text_replace should return PDF_OK.

2. The contents of the output text object remain empty.

pdf_text_replace_ascii

Test: pdf_text_replace_ascii_001

Replace an old non-empty ASCII pattern with a new ASCII non-empty pattern of different sizes (old > new). At least one replacement is done.

Success conditions

1. The call to pdf_text_replace_ascii should return PDF_OK.

2. The contents of the output text object must be the expected ones.

Test: pdf_text_replace_ascii_002

Replace an old non-empty ASCII pattern with a new non-empty ASCII pattern of different sizes (old < new). At least one replacement is done.

Success conditions

1. The call to pdf_text_replace_ascii should return PDF_OK.

2. The contents of the output text object must be the expected ones.

Test: pdf_text_replace_ascii_003

Replace an old non-empty ASCII pattern with a new non-empty ASCII pattern of same sizes. At least one replacement is done.

Success conditions

1. The call to pdf_text_replace_ascii should return PDF_OK.

2. The contents of the output text object must be the expected ones.

Test: pdf_text_replace_ascii_004

Replace an old non-empty ASCII pattern with a new empty ASCII pattern (remove old pattern from text). At least one replacement is done.

Success conditions

1. The call to pdf_text_replace_ascii should return PDF_OK.

2. The contents of the output text object must be the expected ones.

Test: pdf_text_replace_ascii_005

Replace an old non-empty ASCII pattern with a new non-empty ASCII pattern of different sizes (old > new). No replacement is done.

Success conditions

1. The call to pdf_text_replace_ascii should return PDF_OK.

2. The contents of the output text object remain unchanged.

Test: pdf_text_replace_ascii_006

Replace an old non-empty ASCII pattern with a new non-empty ASCII pattern of different sizes (old < new). No replacement is done.

Success conditions

1. The call to pdf_text_replace_ascii should return PDF_OK.

2. The contents of the output text object remain unchanged.

Test: pdf_text_replace_ascii_007

Replace an old non-empty ASCII pattern with a new non-empty ASCII pattern of same sizes. No replacement is done.

Success conditions

1. The call to pdf_text_replace_ascii should return PDF_OK.

2. The contents of the output text object remain unchanged.

Test: pdf_text_replace_ascii_008

Replace an old non-empty ASCII pattern with a new empty ASCII pattern (remove old pattern from text). No replacement is done.

Success conditions

1. The call to pdf_text_replace_ascii should return PDF_OK.

2. The contents of the output text object remain unchanged.

Test: pdf_text_replace_ascii_009

Replace an old empty ASCII pattern with a new non-empty ASCII pattern (old pattern can't be empty!)

Success conditions

1. The call to pdf_text_replace_ascii should NOT return PDF_OK.

Test: pdf_text_replace_ascii_010

Replace an old non-empty ASCII pattern with a new non-empty ASCII pattern in an empty text object.

Success conditions

1. The call to pdf_text_replace_ascii should return PDF_OK.

2. The contents of the output text object remain empty.

Test: pdf_text_replace_ascii_011

Replace an old non-valid ASCII pattern with a new valid ASCII pattern.

Success conditions

1. The call to pdf_text_replace_ascii should NOT return PDF_OK.

Test: pdf_text_replace_ascii_012

Replace an old valid ASCII pattern with a new non-valid ASCII pattern.

Success conditions

1. The call to pdf_text_replace_ascii should NOT return PDF_OK.

pdf_text_filter

Test: pdf_text_filter_001

Apply the `Normalize line endings' filter to a text object which contains different types of line endings.

Success conditions

1. The call to pdf_text_filter should return PDF_OK.

2. The contents of the output text object must be the expected ones.

Test: pdf_text_filter_002

Apply the `Normalize line endings' filter to an empty text object.

Success conditions

1. The call to pdf_text_filter should return PDF_OK.

2. The contents of the output text object must remain unchanged.

Test: pdf_text_filter_003

Apply the `Remove line endings' filter to a text object which contains different types of line endings.

Success conditions

1. The call to pdf_text_filter should return PDF_OK.

2. The contents of the output text object must be the expected ones.

Test: pdf_text_filter_004

Apply the `Remove line endings' filter to an empty text object.

Success conditions

1. The call to pdf_text_filter should return PDF_OK.

2. The contents of the output text object must remain unchanged.

Test: pdf_text_filter_005

Apply the `Remove ampersands' filter to a text object which contains single and double ampersands.

Success conditions

1. The c