FileTools[Text] - 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

Parameters

Description

Examples

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