Функція ADIR( )
Об'єктно-орієнтована та процедурна мова програмування систем управління реляційними базами даних, розроблена корпорацією Microsoft.
Visual FoxPro 9 дозволяє створювати ще більш продуктивні програми баз даних. Двадцятиріччя FoxPro! Microsoft приймає вітання. Visual FoxPro Toolkit for .NET - більше 225 функцій VFP 7.0, для мов .NET (детальніше)
Функція ADIR( )
Заносить до масиву інформацію про файли і повертає кількість файлів.
ADIR(ArrayName[,cFileSkeleton[,cAttribute[,cCreatorType]]])
Вказує ім'я масиву. Якщо встановлено ім'я неіснуючого масиву, Visual FoxPro автоматично створює такий масив. Якщо встановлено ім'я існуючого масиву, який не може вмістити всю інформацію, Visual FoxPro автоматично збільшує розмір масиву належним чином. Якщо в масиві більше елементів, ніж необхідно, Visual FoxPro його вкорочує. Якщо масив вже існує і функція ADIR( ) повертає 0, не знайшовши відповідних файлів, масив не змінюється. Якщо масив немає і функція ADIR( ) повертає 0, то масив не створюється.
У наступній таблиці описано вміст кожного стовпця масиву та тип даних стовпця:
Задає шаблон імен файлів, що визначає певну групу файлів, інформацію про які ви маєте намір зберегти. Можливі, наприклад, такі критерії: всі табличні файли, всі текстові файли, всі файли з іменами, що містять літеру A в якості першої літери, і т.д. У таких випадках у шаблоніcFileSkeletonчасто використовуються символи підстановки * та ?. Знак запитання позначає іночний символ, а зірочка будь-яку кількість символів. У шаблоні можна використовувати будь-яку кількість символів підстановки у будь-яких позиціях.
У VisualFoxPro, FoxPro для Windows і FoxPro для MS-DOS можна задати диск і/і каталог, де буде вестися пошук потрібних файлів. Якщо диск і каталог не задані, інформація про файли поточного каталогу міститься в масив.
У FoxPro для Macintosh можна задати том та/або каталог, в якому буде вестися пошук потрібних файлів. Якщо том і каталог не задані, FoxPro для Macintosh містить інформацію про файли поточного каталогу в масив.
Вказує тип файлів, про які потрібно зібрати інформацію: підкаталоги, приховані чи системні файли чи ім'я тома.
Можна задати будь-яку комбінацію букв D, H і S. Якщо задана буква D, то крім імен файлів, що відповідають шаблонуcFileSkeleton, будуть повернуті імена підкаталогів поточного каталогу. Якщо встановлено букву H, повертається інформація про приховані файли, що відповідають шаблонуcFileSkeleton. Якщо встановлено букву S, буде повернено інформацію про системні файли, що відповідають шаблонуcFileSkeleton.
Якщо в якостіcFileSkeletonвстановлено порожній рядок, буде повернено лише імена підкаталогів, інформація про приховані файли або про системні файли.
У числі атрибутівcAttributeможна вказати букву V, щоб отримати ім'я тома поточного диска. Якщо літера V задана разом з D, H або S, масив повертається тільки ім'я тома. Воно зберігається в першому елементі масиву, решта масиву відсікається.
Допустимо лише у FoxPro для Macintosh.
Задає файли, створені програмою певного типу. Якщо в якостіcFileSkeletonзаданий порожній рядок, в масив будуть занесені тільки файли, створені програмами типуcCreatorType. Якщо якcFileSkeletonзазначений нетривіальний шаблон, в масив заноситься інформація про файли, що задовольняють цьому шаблону і створенідодатками заданогоcCreatorTypeтипу.
Список розширень імен файлів FoxPro для Macintosh та відповідних типів під час одруження див. у розділі Розширення імен файлів та типи файлів.
Для кожного файлу функція ADIR( ) заносить в масив його ім'я, розмір, дату та ім'я створення та атрибути.