Go to Home page
af
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ść.