MMpy.FileStruct.add_field
Синтаксис
structure.add_field(field_name, field_type, field_width=1, field_precision=0)
Описание
Добавить новое поля в объект структуры файла.
Параметры
Имя |
Тип |
Описание |
|---|---|---|
|
field_name |
str | Имя поля. |
| field_type | MMpy.FieldType | Тип поля. |
| field_width | int (на выбор) | Ширина поля. Это меняет значение в зависимости от выбранного типа поля. Смотрите примечания. |
| field_precision | int (на выбор) | Точность (прецизионность) поля. Это меняет значение в зависимости от выбранного типа поля. Смотрите примечания. |
Выдает
Тип |
Описание |
|---|---|
| bool | Выдает True, если поле было добавлено, противном случае - False. |
Смотрите также
MMpy.FileStruct.fields
MMpy.File.get_field_id()
Примечания
Это добавить новое поле в структуру. Прежде чем использовать его, вы все равно должны запросить идентификатор поля после того, как он был добавлен, например, через MMpy.File.get_field_id().
Значение field_width и field_precision зависит от заданного типа поля. Если вам необходима дополнительная, перейдите в тему Изменить структуру файла.
Допустимые варианты для field_type:
- MMpy.FieldType.character
- MMpy.FieldType.numeric
- MMpy.FieldType.real
- MMpy.FieldType.float
- MMpy.FieldType.long
- MMpy.FieldType.short
- MMpy.FieldType.unknown
Примеры
file_path = MMpy.Project.path() + 'test.DAT' file = MMpy.File() file.open(path) structure = file.structure structure.add_field('NewRealField', MMpy.FieldType.real, field_precision=4) structure.add_field('NewCharField', MMpy.FieldType.character, field_width=100) file.structure = structure file.close()
ID ресурса
IDPH_FILESTRUCT_ADDFLD