Long Line Candle (CDLLONGLINE)
Summary
A single-candle pattern: a long real body with short upper and short lower shadow. The signal direction follows the candle color (bullish if white, bearish if black). Signals strong directional conviction on the bar. Not intrinsically a reversal or continuation signal.
Chart
Chart metadata i
Outputs
outInteger:pattern_bull_bear·zero·positive·negative
Inputs
inOpen— Open price of each barinHigh— High price of each barinLow— Low price of each barinClose— Close price of each bar
Outputs
outInteger— +100 on a white (close>=open) long line, -100 on a black long line, 0 when no pattern
Output Values
What candlestick values mean: Candlestick Outputs. The function's flags declare which values it can return: rW7.
| Value | Meaning |
|---|---|
| -100 | Black long-line candle (long body, short shadows) |
| 0 | No pattern |
| 100 | White long-line candle (long body, short shadows) |
Properties
Numerical Stability: Start-Independent
| ☐ Overlap Input |
| ✅ Independent Y-Axis i |
| ✅ Candlestick i |
| ☐ Display Shift |
| ☐ Can Output NaN or ±Inf |
| ☐ Identity at Period 1 |
| ☐ Uses Transcendental |
| ☐ Input Must Be Positive |
Example
C
#include <stdio.h>
#include <ta_libc.h>
int n = 252;
double open[252]; /* your data, oldest first */
double high[252]; /* your data, oldest first */
double low[252]; /* your data, oldest first */
double close[252]; /* your data, oldest first */
int out[252];
int outBegIdx, outNBElement;
TA_Initialize();
TA_CDLLONGLINE( 0, n - 1, open, high, low, close, &outBegIdx, &outNBElement, out );
printf( "%d values from bar %d; last out = %d\n", outNBElement, outBegIdx, out[outNBElement - 1] );Rust
use ta_lib::Core;
let open = vec![0.0; 252]; // your data, oldest first
let high = vec![0.0; 252]; // your data, oldest first
let low = vec![0.0; 252]; // your data, oldest first
let close = vec![0.0; 252]; // your data, oldest first
let mut out = vec![0i32; 252];
let core = Core::new();
let range = core.cdllongline(0, open.len() - 1, &open, &high, &low, &close, &mut out)?;
println!("{} values from bar {}; last out = {}", range.count, range.beg_idx, out[range.count - 1]);Java
import io.github.talib.Core;
import io.github.talib.OutRange;
double[] open = new double[252]; // your data, oldest first
double[] high = new double[252]; // your data, oldest first
double[] low = new double[252]; // your data, oldest first
double[] close = new double[252]; // your data, oldest first
int[] out = new int[252];
Core core = Core.DEFAULT;
OutRange r = core.cdllongline(0, open.length - 1, open, high, low, close, out);
System.out.println(r.count() + " values from bar " + r.begIdx() + "; last out = " + out[r.count() - 1]);C#
using System;
using TALib;
var open = new double[252]; // your data, oldest first
var high = new double[252]; // your data, oldest first
var low = new double[252]; // your data, oldest first
var close = new double[252]; // your data, oldest first
var outInteger = new int[252];
var core = Core.Default;
OutRange r = core.Cdllongline(0, open.Length - 1, open, high, low, close, outInteger);
Console.WriteLine($"{r.Count} values from bar {r.BegIdx}; last outInteger = {outInteger[r.Count - 1]}");TypeScript
import { cdllongline } from 'ta-lib';
const open = new Float64Array(252); // your data, oldest first
const high = new Float64Array(252); // your data, oldest first
const low = new Float64Array(252); // your data, oldest first
const close = new Float64Array(252); // your data, oldest first
const { begIdx, values } = cdllongline({ open, high, low, close });
console.log(values.length + ' values from bar ' + begIdx + '; last values = ' + values[values.length - 1]);Implementation
Added in 0.4.0.
TA-Lib Definition: cdllongline.c · cdllongline.yaml
| Native | File |
|---|---|
| C | ta_CDLLONGLINE.c |
| Rust | cdllongline.rs |
| Java | Core_CDLLONGLINE.java |
| C# | Core_CDLLONGLINE.cs |
| TypeScript | cdllongline.ts |
Python: talib.CDLLONGLINE, see ta-lib-python.
TA-Lib is also available for R and more using a wrapper.
Aliases
Long Line Candle, Long Line
See Also
CDLSHORTLINE · CDLCLOSINGMARUBOZU · CDLMARUBOZU · CDLLONGLEGGEDDOJI