count the occurrences of a character in a file or count the total number of characters in a file - Maple Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Programming : Input and Output : File Manipulation : FileTools : FileTools/Text/CountCharacters

FileTools[Text][CountCharacters] - count the occurrences of a character in a file or count the total number of characters in a file

Calling Sequence

CountCharacters(file)

CountCharacters(file, character)

Parameters

file

-

file descriptor or filename

character

-

string of length 1; character to count

Description

• 

The CountCharacters(file) command counts the number of characters from file's current position to the end of the file.

• 

The CountCharacters(file, character) command counts the number of occurrences of character from file's current position to the end of the file.

• 

As CountCharacters is a Text function, it counts characters, not bytes.  Therefore characters represented as multiple bytes, (like "\\r\\n") are counted as a single character.  This means the number of characters in a file can differ from the number of bytes in a file.

• 

An error is raised if file is not a valid descriptor or if the filename does not exist.

Examples

withFileTools:

withText:

WriteStringfoo,121312141213121:

Closefoo:

CountCharactersfoo

15

(1)

CountCharactersfoo,1

8

(2)

CountCharactersfoo,2

4

(3)

Positionfoo,8:

CountCharactersfoo

7

(4)

CountCharactersfoo,1

4

(5)

CountCharactersfoo,2

2

(6)

Removefoo:

See Also

file, FileTools[Position], FileTools[Remove], FileTools[Text], FileTools[Text][Close], FileTools[Text][CountLines], FileTools[Text][WriteString], IO_errors


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam