Funkcja AFnText()

Alias: GETDATATEXT()

Odpowiednik w Usługach Sieciowych AFin Web Services: GETDATATEXT

Argumentem funkcji AFinText może być dowolny tekst - zarówno, podany jako tekstowy argument funkcji, jak i adres pośredni do pliku z tekstem, czyli adres pliku tekstowego na dysku, jako strona internetowa, czyli adres URL, jak i jako plik MS WORD na dysku. Plik taki odczytywany jest do pamięci i tam odbywa się szereg przetworzeń tekstu, aby właściwie odczytać żądane informacje.
Jest to funkcja skalarna lub tablicowa, gdy zastosowana w Excel 365 przyjmuje postać "rozlaną".

Wywołanie funkcji

AFnText(strTextSource; …

… [strPatternToReplaceBefore]; [strPatternToMatch]; [strPatternToReplaceAfter]; [strWhatToDoWithTableReturned])

Stosowane symbole: [afrt] (skrót od "AF Replace To") lub (:) - separator zamiany; REGEX - wyrażenia regularne (Pomoc >>> Internet)

Argumenty

strTextSource (wymagany) - Określa źródło tekstu - może być podany jako:

* bezpośrednio tekst - "abcdABCD" - przydatne, gdy chcemy użyć możliwości funkcji do konkretnego tekstu, np. zamienić w nim znaki lub podzielić go na tablicę tekstów według separatora REGEX, np. podziel tekst, stosując dowolną cyfrę (zbiór cyfr) jako separatory.

* ścieżka do pliku tekstowego - "C:\Path\TextFile.txt"

* URL - "http://example.com/path/file.txt"

* ścieżka do pliku MS Word - "C:\Path\WordDocument.doc"

strPatternToReplaceBefore (opcjonalny) - Zamiana znaków wstępna

Zamienia znaki przed(!) wyszukaniem tekstu, działa na całym tekście - jak standardowa funkcja REGEX_Replace - przydatne, przede wszystkim, do wstępnego czyszczenia tekstu. Gdy nie jest podany, zamiany nie są dokonywane.

strPatternToMatch (opcjonalny) - Wyszukanie wzorca REGEX

Wyszukuje tekst za pomocą ciągu REGEX, działa jak standardowa funkcja REGEX_Match. Zwraca tablicę wyników, której formę definiuje ostatni argument [strWhatToDoWithTableReturned]. Gdy nie jest podany - funkcja zwraca tekst pierwotny po działaniu zamian tekstu.

strPatternToReplaceAfter (opcjonalny) - Zamiana znaków na wyjściu

Zamienia znaki po(!) wyszukaniu żądanego tekstu, działa na tablicy wyników - jak standardowa funkcja REGEX_Replace. Bardzo często używana opcja, gdyż ciągi tekstowe w tablicy wyników wymagają dodatkowego ulepszenia - najbardziej klasycznym przykładem jest wyszukanie liczb z miejscami po przecinku, które na stronach internetowych prawie zawsze są kropkami. Żeby te ciągi cyfr były jednak poprawnymi liczbami, należy zamienić kropkę na przecinek, a bardzo często dodatkowo pozbyć się separatora tysięcy, np. spacji lub przecinka. Przykład "\.[afrt]," (zamień kropkę na przecinek)

strWhatToDoWithTableReturned (opcjonalny) - format wyniku

Określa w jakiej formie zwrócić wynik - patrz też argument "strParameters" w innych funkcjach, np.
out=l zwraca listę,
out=t zwraca tablicę,
out=v - wartość.