mirror of
https://github.com/ArthurSonzogni/FTXUI.git
synced 2025-12-16 01:48:56 +08:00
370 lines
16 KiB
HTML
370 lines
16 KiB
HTML
|
<!-- HTML header for doxygen 1.9.8-->
|
||
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
||
|
|
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
|
||
|
|
<meta name="generator" content="Doxygen 1.12.0"/>
|
||
|
|
<meta name="viewport" content="width=device-width, initial-scale=1"/>
|
||
|
|
<title>FTXUI: Entrada canalizada POSIX en FTXUI</title>
|
||
|
|
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
||
|
|
<script type="text/javascript" src="jquery.js"></script>
|
||
|
|
<script type="text/javascript" src="dynsections.js"></script>
|
||
|
|
<script type="text/javascript" src="doxygen-awesome-fragment-copy-button.js"></script>
|
||
|
|
<script type="text/javascript" src="doxygen-awesome-paragraph-link.js"></script>
|
||
|
|
<script type="text/javascript" src="doxygen-awesome-interactive-toc.js"></script>
|
||
|
|
<script type="text/javascript" src="doxygen-awesome-tabs.js"></script>
|
||
|
|
<script type="module">
|
||
|
|
DoxygenAwesomeFragmentCopyButton.init()
|
||
|
|
DoxygenAwesomeParagraphLink.init()
|
||
|
|
DoxygenAwesomeInteractiveToc.init()
|
||
|
|
DoxygenAwesomeTabs.init()
|
||
|
|
await new Promise(r => window.addEventListener('DOMContentLoaded', r));
|
||
|
|
// Remove title when a img[alt='title-img'] is present.
|
||
|
|
// Find an image with the alt "img-title".
|
||
|
|
const img = document.querySelector("img[alt='title-img']");
|
||
|
|
const header = document.querySelector(".headertitle");
|
||
|
|
if (img && header) {
|
||
|
|
// Hide the header title progressively.
|
||
|
|
header.style.display = "none";
|
||
|
|
// Show progressively the image.
|
||
|
|
img.style.maxHeight = "40vh";
|
||
|
|
img.style.maxWidth = "100%";
|
||
|
|
img.style.objectFit = "contain";
|
||
|
|
}
|
||
|
|
// In the "examples.html" page. Turn every link with text
|
||
|
|
// "examples/<...>
|
||
|
|
//
|
||
|
|
// Add a "demo" link toward.
|
||
|
|
// https://arthursonzogni.github.io/FTXUI/examples/?file=<...>
|
||
|
|
const examples = document.querySelectorAll("a")
|
||
|
|
examples.forEach((example) => {
|
||
|
|
if (!example.textContent.startsWith("examples/")) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
// Remove the ".cpp" extension from the example name.
|
||
|
|
const exampleName = example.textContent.replace("examples/", "").replace(".cpp", "");
|
||
|
|
const a = document.createElement("a");
|
||
|
|
a.textContent = "[demo]";
|
||
|
|
a.href = "https://arthursonzogni.github.io/FTXUI/examples/?file=" + exampleName;
|
||
|
|
a.style.marginRight= "1em";
|
||
|
|
a.style.fontWeight = "bold";
|
||
|
|
example.parentElement.insertBefore(a, example)
|
||
|
|
});
|
||
|
|
// If the current URL ends with -example.html, we can add a link to the demo
|
||
|
|
// as well using the div.title textContent.
|
||
|
|
const url = new URL(window.location.href);
|
||
|
|
if (url.pathname.endsWith("-example.html")) {
|
||
|
|
// Get the title text.
|
||
|
|
const title = document.querySelector("div.title").textContent;
|
||
|
|
const example = title.replace("examples/", "").replace(".cpp", "");
|
||
|
|
// Create a link to the demo.
|
||
|
|
const a = document.createElement("a");
|
||
|
|
a.textContent = "[demo]";
|
||
|
|
a.href = "https://arthursonzogni.github.io/FTXUI/examples/?file=" + example;
|
||
|
|
a.style.marginLeft = "1em";
|
||
|
|
a.style.fontWeight = "bold";
|
||
|
|
a.style.display = "inline-block";
|
||
|
|
// Insert the link after the title.
|
||
|
|
const titleDiv = document.querySelector("div.title");
|
||
|
|
if (titleDiv) {
|
||
|
|
titleDiv.insertBefore(a, titleDiv.nextSibling);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
</script>
|
||
|
|
<script type="module">
|
||
|
|
// Ignore non english pages and/or the main page.
|
||
|
|
const excluded_lang = [
|
||
|
|
"/de",
|
||
|
|
"/es",
|
||
|
|
"/fr",
|
||
|
|
"/it",
|
||
|
|
"/ja",
|
||
|
|
"/ja",
|
||
|
|
"/ko"
|
||
|
|
"/ru",
|
||
|
|
"/zh-CH",
|
||
|
|
"/zh-TW",
|
||
|
|
]
|
||
|
|
if (excluded_lang.some(lang => window.location.pathname.startsWith(lang)) ||
|
||
|
|
window.location.pathname.endsWith("index.html")) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
// Click on the navtree, except for the main page where this is already done
|
||
|
|
// automatically.
|
||
|
|
let delay = 0;
|
||
|
|
while(true) {
|
||
|
|
const navtree = document.querySelector("div.item.selected");
|
||
|
|
if (!navtree) {
|
||
|
|
delay *= 2;
|
||
|
|
delay += 1;
|
||
|
|
await new Promise(resolve => setTimeout(resolve, delay));
|
||
|
|
continue;
|
||
|
|
}
|
||
|
|
// Include only selected navtree items.
|
||
|
|
console.log("navtree.textContent", navtree.textContent);
|
||
|
|
if (!navtree.textContent.includes("Getting Started") &&
|
||
|
|
!navtree.textContent.includes("Installation") &&
|
||
|
|
!navtree.textContent.includes("ftxui / screen") &&
|
||
|
|
!navtree.textContent.includes("ftxui / dom") &&
|
||
|
|
!navtree.textContent.includes("ftxui / component") &&
|
||
|
|
!navtree.textContent.includes("Reference")) {
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
// Find the first link inside the navtree.
|
||
|
|
const link = navtree.querySelector("a");
|
||
|
|
if (link) {
|
||
|
|
// Simulate a click on the link.
|
||
|
|
link.click();
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
</script>
|
||
|
|
<link href="navtree.css" rel="stylesheet" type="text/css"/>
|
||
|
|
<script type="text/javascript" src="navtreedata.js"></script>
|
||
|
|
<script type="text/javascript" src="navtree.js"></script>
|
||
|
|
<script type="text/javascript" src="resize.js"></script>
|
||
|
|
<script type="text/javascript" src="cookie.js"></script>
|
||
|
|
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
||
|
|
<script type="text/javascript" src="search/searchdata.js"></script>
|
||
|
|
<script type="text/javascript" src="search/search.js"></script>
|
||
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
||
|
|
<link href="doxygen-awesome.css" rel="stylesheet" type="text/css"/>
|
||
|
|
<link href="stylesheet.css" rel="stylesheet" type="text/css"/>
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
||
|
|
<div id="titlearea">
|
||
|
|
<table cellspacing="0" cellpadding="0">
|
||
|
|
<tbody>
|
||
|
|
<tr id="projectrow">
|
||
|
|
<td id="projectalign">
|
||
|
|
<div id="projectname">FTXUI<span id="projectnumber"> 6.1.9</span>
|
||
|
|
</div>
|
||
|
|
<div id="projectbrief">C++ functional terminal UI.</div>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<!-- end header part -->
|
||
|
|
<!-- Generated by Doxygen 1.12.0 -->
|
||
|
|
<script type="text/javascript">
|
||
|
|
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
|
||
|
|
var searchBox = new SearchBox("searchBox", "search/",'.html');
|
||
|
|
/* @license-end */
|
||
|
|
</script>
|
||
|
|
<script type="text/javascript">
|
||
|
|
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
|
||
|
|
$(function() { codefold.init(0); });
|
||
|
|
/* @license-end */
|
||
|
|
</script>
|
||
|
|
<script type="text/javascript" src="menudata.js"></script>
|
||
|
|
<script type="text/javascript" src="menu.js"></script>
|
||
|
|
<script type="text/javascript">
|
||
|
|
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
|
||
|
|
$(function() {
|
||
|
|
initMenu('',true,false,'search.php','Search',true);
|
||
|
|
$(function() { init_search(); });
|
||
|
|
});
|
||
|
|
/* @license-end */
|
||
|
|
</script>
|
||
|
|
<div id="main-nav"></div>
|
||
|
|
</div><!-- top -->
|
||
|
|
<div id="side-nav" class="ui-resizable side-nav-resizable">
|
||
|
|
<div id="nav-tree">
|
||
|
|
<div id="nav-tree-contents">
|
||
|
|
<div id="nav-sync" class="sync"></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div id="splitbar" style="-moz-user-select:none;"
|
||
|
|
class="ui-resizable-handle">
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<script type="text/javascript">
|
||
|
|
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
|
||
|
|
$(function(){initNavTree('md_doc_2posix__pipe.html',''); initResizable(true); });
|
||
|
|
/* @license-end */
|
||
|
|
</script>
|
||
|
|
<div id="doc-content">
|
||
|
|
<!-- window showing the filter options -->
|
||
|
|
<div id="MSearchSelectWindow"
|
||
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
||
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
||
|
|
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<!-- iframe showing the search results (closed by default) -->
|
||
|
|
<div id="MSearchResultsWindow">
|
||
|
|
<div id="MSearchResults">
|
||
|
|
<div class="SRPage">
|
||
|
|
<div id="SRIndex">
|
||
|
|
<div id="SRResults"></div>
|
||
|
|
<div class="SRStatus" id="Loading">Loading...</div>
|
||
|
|
<div class="SRStatus" id="Searching">Searching...</div>
|
||
|
|
<div class="SRStatus" id="NoMatches">No Matches</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div><div class="header">
|
||
|
|
<div class="headertitle"><div class="title">Entrada canalizada POSIX en FTXUI</div></div>
|
||
|
|
</div><!--header-->
|
||
|
|
<div class="contents">
|
||
|
|
<div class="textblock"><p><a class="anchor" id="entrada-canalizada-posix-en-ftxui"></a></p>
|
||
|
|
<dl class="section warning"><dt>Warning</dt><dd>Esta característica funciona solo en Linux y macOS. No es compatible con Windows y WebAssembly.</dd></dl>
|
||
|
|
<h1><a class="anchor" id="qué-es-una-tubería-posix"></a>
|
||
|
|
¿Qué es una tubería POSIX?</h1>
|
||
|
|
<p>Una tubería POSIX es una forma en que dos programas separados pueden comunicarse. Un programa envía su salida directamente como entrada a otro programa. Piense en ello como un tubo unidireccional para datos.</p>
|
||
|
|
<p><b>Ejemplo:</b></p>
|
||
|
|
<p>Imagine que desea listar archivos y luego filtrarlos interactivamente.</p>
|
||
|
|
<ul>
|
||
|
|
<li><code>ls</code>: Lista archivos.</li>
|
||
|
|
<li><code>interactive_grep</code>: Una aplicación FTXUI que filtra texto y le permite escribir.</li>
|
||
|
|
</ul>
|
||
|
|
<p>Puede conectarlos con una tubería (<code>|</code>):</p>
|
||
|
|
<div class="fragment"><div class="line">ls -l | interactive_grep</div>
|
||
|
|
</div><!-- fragment --><p>Esto es lo que sucede:</p><ol type="1">
|
||
|
|
<li><code>ls -l</code> lista archivos con detalles.</li>
|
||
|
|
<li>El <code>|</code> envía esta lista directamente a <code>interactive_grep</code>.</li>
|
||
|
|
<li><code>interactive_grep</code> recibe la lista y la muestra. Debido a que es una aplicación FTXUI, puede escribir para filtrar la lista, aunque recibió datos iniciales de <code>ls</code>.</li>
|
||
|
|
</ol>
|
||
|
|
<h1><a class="anchor" id="cómo-ftxui-maneja-la-entrada-canalizada"></a>
|
||
|
|
Cómo FTXUI maneja la entrada canalizada</h1>
|
||
|
|
<p>Ahora que comprende qué es una tubería POSIX, veamos cómo las usa FTXUI.</p>
|
||
|
|
<p>FTXUI permite que su aplicación lea datos de otros programas (como de una tubería) sin dejar de permitirle usar su teclado para la interacción. Esto es útil para herramientas interactivas de línea de comandos que procesan datos.</p>
|
||
|
|
<p>Normalmente, las aplicaciones FTXUI reciben toda la entrada de <code>stdin</code>. Sin embargo, cuando FTXUI detecta que <code>stdin</code> está conectado a la salida de una tubería (lo que significa que los datos se están canalizando a su aplicación), cambia automáticamente a leer la entrada interactiva del teclado desde <code>/dev/tty</code>. Esto asegura que su aplicación aún pueda recibir la entrada del usuario incluso mientras procesa datos canalizados.</p>
|
||
|
|
<p>Esta característica está <b>activada por defecto</b>.</p>
|
||
|
|
<p>Si su aplicación FTXUI necesita leer datos canalizados y también responder a la entrada del teclado, normalmente no necesita hacer nada especial:</p>
|
||
|
|
<div class="fragment"><div class="line"><span class="keyword">auto</span> <a class="code hl_variable" href="composition_8cpp.html#af714c99ec9f8e04253d194a65f0e9ed8">screen</a> = ScreenInteractive::Fullscreen();</div>
|
||
|
|
<div class="line"><span class="comment">// screen.HandlePipedInput(true); // Esto está habilitado por defecto</span></div>
|
||
|
|
<div class="line"><a class="code hl_variable" href="composition_8cpp.html#af714c99ec9f8e04253d194a65f0e9ed8">screen</a>.Loop(component);</div>
|
||
|
|
<div class="ttc" id="acomposition_8cpp_html_af714c99ec9f8e04253d194a65f0e9ed8"><div class="ttname"><a href="composition_8cpp.html#af714c99ec9f8e04253d194a65f0e9ed8">screen</a></div><div class="ttdeci">auto screen</div><div class="ttdef"><b>Definition</b> <a href="composition_8cpp_source.html#l00056">composition.cpp:56</a></div></div>
|
||
|
|
</div><!-- fragment --><h1><a class="anchor" id="desactivación-de-la-entrada-canalizada"></a>
|
||
|
|
Desactivación de la entrada canalizada</h1>
|
||
|
|
<p>Si no necesita esta característica, o si entra en conflicto con su manejo de entrada personalizado, puede desactivarla.</p>
|
||
|
|
<p>Para deshabilitarla, llame a <code>HandlePipedInput(false)</code> antes de iniciar el bucle principal de su aplicación:</p>
|
||
|
|
<div class="fragment"><div class="line"><span class="keyword">auto</span> <a class="code hl_variable" href="composition_8cpp.html#af714c99ec9f8e04253d194a65f0e9ed8">screen</a> = ScreenInteractive::Fullscreen();</div>
|
||
|
|
<div class="line"><a class="code hl_variable" href="composition_8cpp.html#af714c99ec9f8e04253d194a65f0e9ed8">screen</a>.HandlePipedInput(<span class="keyword">false</span>); <span class="comment">// Desactiva el manejo de entrada canalizada</span></div>
|
||
|
|
<div class="line"><a class="code hl_variable" href="composition_8cpp.html#af714c99ec9f8e04253d194a65f0e9ed8">screen</a>.Loop(component);</div>
|
||
|
|
</div><!-- fragment --> </div></div><!-- contents -->
|
||
|
|
</div><!-- PageDoc -->
|
||
|
|
</div><!-- doc-content -->
|
||
|
|
<!-- HTML footer for doxygen 1.9.8-->
|
||
|
|
<!-- start footer part -->
|
||
|
|
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
|
||
|
|
</div>
|
||
|
|
<script>
|
||
|
|
document.addEventListener('DOMContentLoaded', function() {
|
||
|
|
const projectNumber = document.getElementById('projectname');
|
||
|
|
|
||
|
|
if (!projectNumber) {
|
||
|
|
console.warn('Doxygen element with ID "projectnumber" not found. Cannot add version switcher.');
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
|
||
|
|
const langs = ["en", "es", "fr", "ja", "zh-CH", "zh-TW"];
|
||
|
|
const lang_paths = {"en": "../index.html", "es": "index.html", "fr": "../fr/index.html", "ja": "../ja/index.html", "zh-CH": "../zh-CH/index.html", "zh-TW": "../zh-TW/index.html"};
|
||
|
|
const lang_display = {"en": "English", "es": "Espa\u00f1ol", "fr": "Fran\u00e7ais", "ja": "\u65e5\u672c\u8a9e", "zh-CH": "\u4e2d\u6587 (\u7b80\u4f53)", "zh-TW": "\u4e2d\u6587 (\u7e41\u9ad4)"};
|
||
|
|
const versions = ["main"];
|
||
|
|
const version_paths = {"main": "index.html"};
|
||
|
|
const currentLang = "es";
|
||
|
|
const currentVersion = "main";
|
||
|
|
|
||
|
|
// Helper function to create a styled select element
|
||
|
|
const createSelect = (options, current, paths, label, displayMap = null) => {
|
||
|
|
const select = document.createElement('select');
|
||
|
|
select.title = label;
|
||
|
|
select.onchange = function() {
|
||
|
|
const selectedValue = this.value;
|
||
|
|
if (selectedValue in paths) {
|
||
|
|
window.location.href = paths[selectedValue];
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
// Sort versions: 'main' first, then others numerically descending.
|
||
|
|
options.sort((a, b) => {
|
||
|
|
if (a === 'main') return -1;
|
||
|
|
if (b === 'main') return 1;
|
||
|
|
return b.localeCompare(a, undefined, { numeric: true, sensitivity: 'base' });
|
||
|
|
});
|
||
|
|
|
||
|
|
options.forEach(v => {
|
||
|
|
const option = document.createElement('option');
|
||
|
|
option.value = v;
|
||
|
|
// Use the displayMap if provided, otherwise default to the value (v)
|
||
|
|
option.textContent = displayMap ? displayMap[v] : v;
|
||
|
|
if (v === current) {
|
||
|
|
option.selected = true;
|
||
|
|
}
|
||
|
|
select.appendChild(option);
|
||
|
|
});
|
||
|
|
|
||
|
|
// Apply some styling to make it look good.
|
||
|
|
Object.assign(select.style, {
|
||
|
|
backgroundColor: 'rgba(0, 0, 0, 0.8)',
|
||
|
|
color: 'white',
|
||
|
|
border: '1px solid rgba(255, 255, 255, 0.2)',
|
||
|
|
padding: '5px',
|
||
|
|
borderRadius: '5px',
|
||
|
|
fontSize: '14px',
|
||
|
|
fontFamily: 'inherit',
|
||
|
|
margin: '0 5px 0 0',
|
||
|
|
cursor: 'pointer'
|
||
|
|
});
|
||
|
|
return select;
|
||
|
|
};
|
||
|
|
|
||
|
|
// 1. Create Language Switcher, passing the language display names map
|
||
|
|
const langSelect = createSelect(langs, currentLang, lang_paths, 'Select Language', lang_display);
|
||
|
|
|
||
|
|
// 2. Create Version Switcher
|
||
|
|
const versionSelect = createSelect(versions, currentVersion, version_paths, 'Select Version');
|
||
|
|
|
||
|
|
// 3. Create FTXUI title.
|
||
|
|
const ftxuiTitle = document.createElement('span');
|
||
|
|
ftxuiTitle.textContent = 'FTXUI: ';
|
||
|
|
Object.assign(ftxuiTitle.style, {
|
||
|
|
color: 'white',
|
||
|
|
fontSize: '20px',
|
||
|
|
fontWeight: 'bold',
|
||
|
|
marginRight: '10px'
|
||
|
|
});
|
||
|
|
|
||
|
|
// 3. Create a container to hold both selectors
|
||
|
|
const container = document.createElement('div');
|
||
|
|
container.id = 'version-lang-switchers';
|
||
|
|
Object.assign(container.style, {
|
||
|
|
display: 'flex',
|
||
|
|
alignItems: 'center',
|
||
|
|
justifyContent: 'flex-end',
|
||
|
|
width: 'auto'
|
||
|
|
});
|
||
|
|
container.appendChild(ftxuiTitle);
|
||
|
|
container.appendChild(langSelect);
|
||
|
|
container.appendChild(versionSelect);
|
||
|
|
|
||
|
|
Object.assign(container.style, {
|
||
|
|
backgroundColor: 'rgba(0, 0, 0, 0.5)',
|
||
|
|
padding: '5px 10px',
|
||
|
|
borderRadius: '8px'
|
||
|
|
});
|
||
|
|
|
||
|
|
|
||
|
|
// Replace the Doxygen project number element with our container.
|
||
|
|
projectNumber.replaceWith(container);
|
||
|
|
|
||
|
|
// Clean up the original Doxygen project number text if it still exists nearby
|
||
|
|
const parent = container.parentElement;
|
||
|
|
if (parent) {
|
||
|
|
const textNode = Array.from(parent.childNodes).find(n => n.nodeType === 3 && n.textContent.trim() !== '');
|
||
|
|
if (textNode) {
|
||
|
|
textNode.remove();
|
||
|
|
}
|
||
|
|
}
|
||
|
|
});
|
||
|
|
</script>
|
||
|
|
</body>
|
||
|
|
</html>
|