1.164.2 Send methods

text_buffer ->append: text=char_array, times=[int]

Append the indicated text n times at the end of the buffer. See also text_buffer->insert and text_buffer->format.

text_buffer ->attach: editor

Inherits description from: text_buffer-editors

text_buffer ->capitalise: from=int, size=int

Change the case in the specified region. Each start of a word is changed to uppercase, the remainder of the word to lowercase.

text_buffer ->check_point_undo:

Create a no-change checkpoint in the undo buffer. If text_buffer->undo reverts back to this point, text_buffer<-modified will be reset to @off.

text_buffer ->contents: char_array

Replace the text_buffer<-contents of the text_buffer object. In addition, it resets the text_buffer->undo system and deletes all associated fragment objects.

See also text_buffer->insert_file.

text_buffer ->delete: at=int, characters=[int]

Delete characters forwards from the given (0-based) index. The second argument is the number of characters to be deleted.

Defaults:

By default, 1 character is deleted.

text_buffer ->detach: editor

Inherits description from: text_buffer-editors

text_buffer ->for_all_fragments: code

Iterate code over all fragments. The code object is allowed to create and/or destroy fragments associated with this text_buffer object. See also text_buffer<-find_fragment and text_buffer<-find_all_fragments. Arguments:

@arg1	The fragment object

text_buffer ->format: format=char_array, argument=any ...

text_buffer->append formatted text. See string->format for the definition of the format string and its arguments.

text_buffer ->in_string: index=int, start=[int]

Test if first index is in string constant.

text_buffer ->in_comment: index=int, start=[int]

Succeed if the indicated index is in a comment/string statement of the target language. By default it starts scanning from the start of the buffer. If start is specified it will start scanning from this index, assuming that the given index is not in a string or comment. See syntax_table->syntax for defining the comment syntax.

text_buffer ->initialise: contents=[char_array]

Create a text_buffer object. The argument defines the initial contents.

text_buffer ->insert_file: at=int, data=source_sink, times=[int]

Insert the given file at the indicated position. Times is the number of times the file is inserted and defaults to 1. This method sets the file<->newline_mode if it is set to detect at entry to simplify Windows/Unix interaction. This is exploited by PceEmacs.

See also text_buffer->save, text_buffer->contents and class editor.

text_buffer ->iso_latin_1:

Succeed if the text_buffer object uses 8-bit ISO Latin-1 encoding or after successful conversion from wide-character encoding to ISO Latin-1. It can be used to see whether the memory footprint can be lowered or to test whether it is possible to save the text using ISO Latin-1 encoding.

See also file->encoding.

text_buffer ->mark_undo:

Set a mark on the undo buffer if there is no mark at the head of the undo buffer. A subsequent undo will text_buffer->undo all changes back to this mark. Normally set by editor->event.

text_buffer ->report: kind={status,inform,progress,done,warning,error,fatal}, format=[char_array], argument=any ...

Report to all associated text_buffer<-editors. See editor->report and‘visual text_buffer->report’.

text_buffer ->reset_undo:

Clear the undo-buffer. Actually also deallocates the buffer. On the first modification a new buffer will be created.

text_buffer ->save: in=file, from=[int], size=[int]

Save (part-of) the text_buffer's content in the given file. The default from is 0 and the size will save to the end of the buffer. If both from and size are omitted, text_buffer<-modified will be set to @off. See also editor->save and editor->save_buffer.

text_buffer ->sort: from=[int], to=[int]

Sort the lines between the indicated character indices alphabetically.

Bugs: Not very flexible and doubtfful, whether this is the right level for implementing this method.

text_buffer ->undo:

Undo all changes to the text_buffer back to the last text_buffer->undo_mark. If this is a text_buffer->reset_undo checkpoint, reset text_buffer->modified to @off. Changes are stored in a buffer of size text_buffer<-undo_buffer_size. Changes that exhaust the size of this buffer are lost.

text_buffer ->unlink:

Send editor->lost_text_buffer to all related text_buffer<-editors and returns all alien resources to the system.